https://github.com/noblemajo/ubuntudind
Ubuntu Docker in Docker - a ubuntu 24.04 docker in docker image
https://github.com/noblemajo/ubuntudind
dind docker docker-image ubuntu ubuntu2004
Last synced: 10 months ago
JSON representation
Ubuntu Docker in Docker - a ubuntu 24.04 docker in docker image
- Host: GitHub
- URL: https://github.com/noblemajo/ubuntudind
- Owner: NobleMajo
- License: mit
- Created: 2022-02-08T16:48:57.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-22T11:24:59.000Z (over 1 year ago)
- Last Synced: 2025-08-15T19:09:28.141Z (10 months ago)
- Topics: dind, docker, docker-image, ubuntu, ubuntu2004
- Language: Shell
- Homepage:
- Size: 56.6 KB
- Stars: 14
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# ubuntudind
# table of contents
- [ubuntudind](#ubuntudind)
- [table of contents](#table-of-contents)
- [about](#about)
- [example commands](#example-commands)
- [pull image](#pull-image)
- [Own docker sock](#own-docker-sock)
- [Host sock](#host-sock)
- [Exec commands](#exec-commands)
- [Nginx example](#nginx-example)
- [Persistent data](#persistent-data)
- [Control Scripts](#control-scripts)
- [Contributing](#contributing)
- [License](#license)
- [Disclaimer](#disclaimer)
# about
The main focus of this project is to provide a ubuntu image with functional docker deamon.
You can use this image to run docker containers in a ubuntu container.
## docker hub
This repo is also on [Docker Hub](https://hub.docker.com/r/noblemajo/ubuntudind).
## automated updates
The build image is automatically updated without worrying about a dead repo or less maintenance.
# requirements
This container needs the '--privileged' flag to run!
This gives extended privileges to this container.
# example commands
## pull image
```sh
docker push noblemajo/ubuntudind
```
## own docker sock
Start the container as self hosting docker instance:
```sh
docker run -d --privileged \
--restart unless-stopped \
--name ubuntudind \
--network host \
noblemajo/ubuntudind
```
## host sock
You can also mount the host docker socket into the container:
```sh
docker run -it --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
noblemajo/ubuntudind \
docker ps
```
## exec commands
```sh
docker exec -it ubuntudind \
docker ps
```
## nginx example
```sh
docker exec -it ubuntudind \
docker run -it --rm \
--name test-nginx \
-p 8080:80 \
nginx
```
Don't forget to remove it:
```sh
docker rm -f ubuntudind
```
## persistent data
The container data need to be mounted for persistency:
```sh
docker run -d --privileged \
--restart unless-stopped \
--name ubuntudind \
--network host \
-v $(pwd)/.store:/var/lib/docker \
noblemajo/ubuntudind
```
# control Scripts
This control scripts should help you to understand how to use the image and container.
- build.sh - build docker image
- enter.sh - run a container with bash as entrypoint for image testing and debugging purposes
- start.sh - run docker "test" container with network, volume and backup/cache mount to "./.store"
- remove.sh - remove docker "test" container
- exec.sh - runs a command in the "test" container and prints the output
- test.sh - runs a nginx container that bind port 8080 in the "test" container and prints the output
# Contributing
Contributions to Ubuntudind are welcome!
Interested users can refer to the guidelines provided in the [CONTRIBUTING.md](CONTRIBUTING.md) file to contribute to the project and help improve its functionality and features.
# License
Ubuntudind is licensed under the [MIT license](LICENSE), providing users with flexibility and freedom to use and modify the software according to their needs.
# Disclaimer
Ubuntudind is provided without warranties.
Users are advised to review the accompanying license for more information on the terms of use and limitations of liability.