2014-05-23 09:53:11 -04:00
|
|
|
page_title: Installation on CentOS
|
2014-05-27 09:59:30 -04:00
|
|
|
page_description: Instructions for installing Docker on CentOS
|
2014-05-23 09:53:11 -04:00
|
|
|
page_keywords: Docker, Docker documentation, requirements, linux, centos, epel, docker.io, docker-io
|
|
|
|
|
|
|
|
# CentOS
|
|
|
|
|
|
|
|
> **Note**:
|
|
|
|
> Docker is still under heavy development! We don't recommend using it in
|
|
|
|
> production yet, but we're getting closer with each release. Please see
|
|
|
|
> our blog post, [Getting to Docker 1.0](
|
|
|
|
> http://blog.docker.io/2013/08/getting-to-docker-1-0/)
|
|
|
|
|
|
|
|
> **Note**:
|
|
|
|
> This is a community contributed installation path. The only `official`
|
|
|
|
> installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux)
|
|
|
|
> installation path. This version may be out of date because it depends on
|
2014-05-27 09:59:30 -04:00
|
|
|
> some binaries to be updated and published.
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
The Docker package is available via the EPEL repository. These instructions work
|
|
|
|
for CentOS 6 and later. They will likely work for other binary compatible EL6
|
|
|
|
distributions such as Scientific Linux, but they haven't been tested.
|
|
|
|
|
|
|
|
Please note that this package is part of [Extra Packages for Enterprise
|
|
|
|
Linux (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort
|
|
|
|
to create and maintain additional packages for the RHEL distribution.
|
|
|
|
|
|
|
|
Also note that due to the current Docker limitations, Docker is able to
|
|
|
|
run only on the **64 bit** architecture.
|
|
|
|
|
|
|
|
To run Docker, you will need [CentOS6](http://www.centos.org) or higher, with
|
|
|
|
a kernel version 2.6.32-431 or higher as this has specific kernel fixes
|
|
|
|
to allow Docker to run.
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
Firstly, you need to ensure you have the EPEL repository enabled. Please
|
|
|
|
follow the [EPEL installation instructions](
|
|
|
|
https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
|
|
|
|
|
|
|
|
The `docker-io` package provides Docker on EPEL.
|
|
|
|
|
|
|
|
If you already have the (unrelated) `docker` package
|
|
|
|
installed, it will conflict with `docker-io`.
|
|
|
|
There's a [bug report](
|
|
|
|
https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
|
|
|
|
To proceed with `docker-io` installation, please remove `docker` first.
|
|
|
|
|
|
|
|
Next, let's install the `docker-io` package which
|
|
|
|
will install Docker on our host.
|
|
|
|
|
2014-05-24 09:33:41 -04:00
|
|
|
$ sudo yum install docker-io
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
Now that it's installed, let's start the Docker daemon.
|
|
|
|
|
2014-05-24 09:33:41 -04:00
|
|
|
$ sudo service docker start
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
If we want Docker to start at boot, we should also:
|
|
|
|
|
2014-05-24 09:33:41 -04:00
|
|
|
$ sudo chkconfig docker on
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
Now let's verify that Docker is working. First we'll need to get the latest
|
|
|
|
centos image.
|
|
|
|
|
2014-05-24 09:33:41 -04:00
|
|
|
$ sudo docker pull centos:latest
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
Next we'll make sure that we can see the image by running:
|
|
|
|
|
2014-05-24 09:33:41 -04:00
|
|
|
$ sudo docker images centos
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
This should generate some output similar to:
|
|
|
|
|
2014-05-24 09:33:41 -04:00
|
|
|
$ sudo docker images centos
|
2014-05-23 09:53:11 -04:00
|
|
|
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
|
|
|
|
centos latest 0b443ba03958 2 hours ago 297.6 MB
|
|
|
|
|
|
|
|
Run a simple bash shell to test the image:
|
2014-05-24 09:33:41 -04:00
|
|
|
|
|
|
|
$ sudo docker run -i -t centos /bin/bash
|
2014-05-23 09:53:11 -04:00
|
|
|
|
|
|
|
If everything is working properly, you'll get a simple bash prompt. Type exit to continue.
|
|
|
|
|
|
|
|
**Done!**
|
|
|
|
You can either continue with the [*Hello World*](/examples/hello_world/#hello-world) example,
|
|
|
|
or explore and build on the images yourself.
|
|
|
|
|
|
|
|
## Issues?
|
|
|
|
|
|
|
|
If you have any issues - please report them directly in the
|
2014-05-27 09:59:30 -04:00
|
|
|
[CentOS bug tracker](http://bugs.centos.org).
|