So you want to create your own Base Image? Great!
The specific process will depend heavily on the Linux distribution you want to package. We have some examples below, and you are encouraged to submit pull requests to contribute new ones.
In general, you‘ll want to start with a working machine that is running the distribution you’d like to package as a base image, though that is not required for some tools like Debian's Debootstrap, which you can also use to build Ubuntu images.
It can be as simple as this to create an Ubuntu base image:
$ sudo debootstrap raring raring > /dev/null $ sudo tar -C raring -c . | docker import - raring a29c15f1bf7a $ docker run raring cat /etc/lsb-release DISTRIB_ID=Ubuntu DISTRIB_RELEASE=13.04 DISTRIB_CODENAME=raring DISTRIB_DESCRIPTION="Ubuntu 13.04"
There are more example scripts for creating base images in the Docker GitHub Repo:
scratch
There is a special repository in the Docker registry called scratch
, which was created using an empty tar file:
$ tar cv --files-from /dev/null | docker import - scratch
which you can docker pull
. You can then use that image to base your new minimal containers FROM
:
FROM scratch COPY true-asm /true CMD ["/true"]
The Dockerfile
above is from an extremely minimal image - tianon/true.
There are lots more resources available to help you write your 'Dockerfile`.
Dockerfile
in the reference section.Dockerfile
, we've also written a Dockerfile
Best Practices guide.