2015-06-08 03:07:20 +00:00
<!-- [metadata]>
+++
title = "Create a base image"
description = "How to create base images"
keywords = ["Examples, Usage, base image, docker, documentation, examples"]
[menu.main]
parent = "smn_images"
+++
<![end-metadata]-->
2014-04-16 00:53:12 +00:00
2015-04-21 15:50:09 +00:00
# Create a base image
2014-04-16 00:53:12 +00:00
2015-10-09 23:50:41 +00:00
So you want to create your own [*Base Image* ](../reference/glossary.md#base-image )? Great!
2014-04-16 00:53:12 +00:00
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.
## Create a full image using tar
2014-04-23 20:48:28 +00:00
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
2014-04-16 00:53:12 +00:00
[Debootstrap ](https://wiki.debian.org/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
2015-03-26 18:12:37 +00:00
$ sudo tar -C raring -c . | docker import - raring
2014-04-16 00:53:12 +00:00
a29c15f1bf7a
2015-03-26 18:12:37 +00:00
$ docker run raring cat /etc/lsb-release
2014-04-16 00:53:12 +00:00
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:
2014-07-24 22:19:50 +00:00
- [BusyBox ](https://github.com/docker/docker/blob/master/contrib/mkimage-busybox.sh )
2014-04-23 20:48:28 +00:00
- CentOS / Scientific Linux CERN (SLC) [on Debian/Ubuntu](
2014-07-24 22:19:50 +00:00
https://github.com/docker/docker/blob/master/contrib/mkimage-rinse.sh) or
2014-04-23 20:48:28 +00:00
[on CentOS/RHEL/SLC/etc.](
2014-07-24 22:19:50 +00:00
https://github.com/docker/docker/blob/master/contrib/mkimage-yum.sh)
2014-04-23 20:48:28 +00:00
- [Debian / Ubuntu](
2014-07-24 22:19:50 +00:00
https://github.com/docker/docker/blob/master/contrib/mkimage-debootstrap.sh)
2014-04-16 00:53:12 +00:00
2015-04-20 20:11:46 +00:00
## Creating a simple base image using scratch
2014-04-16 00:53:12 +00:00
2015-04-20 20:11:46 +00:00
You can use Docker's reserved, minimal image, `scratch` , as a starting point for building containers. Using the `scratch` "image" signals to the build process that you want the next command in the `Dockerfile` to be the first filesystem layer in your image.
2014-04-16 00:53:12 +00:00
2015-04-20 20:11:46 +00:00
While `scratch` appears in Docker's repository on the hub, you can't pull it, run it, or tag any image with the name `scratch` . Instead, you can refer to it in your `Dockerfile` . For example, to create a minimal container using `scratch` :
2014-04-16 00:53:12 +00:00
FROM scratch
2015-04-20 20:11:46 +00:00
ADD hello /
CMD ["/hello"]
This example creates the hello-world image used in the tutorials.
If you want to test it out, you can clone [the image repo ](https://github.com/docker-library/hello-world )
2014-04-16 00:53:12 +00:00
2014-09-23 21:21:00 +00:00
## More resources
There are lots more resources available to help you write your 'Dockerfile`.
2015-10-09 23:50:41 +00:00
* There's a [complete guide to all the instructions ](../reference/builder.md ) available for use in a `Dockerfile` in the reference section.
2014-09-23 21:21:00 +00:00
* To help you write a clear, readable, maintainable `Dockerfile` , we've also
2015-10-09 23:50:41 +00:00
written a [`Dockerfile` Best Practices guide ](dockerfile_best-practices.md ).
* If your goal is to create a new Official Repository, be sure to read up on Docker's [Official Repositories ](https://docs.docker.com/docker-hub/official_repos/ ).