Merge pull request #6005 from jimperrin/master

Updated documentation to include CentOS installation instructions.

docs/mkdocs.yml

@@ -35,6 +35,7 @@ pages:
 - ['installation/mac.md', 'Installation', 'Mac OS X']
 - ['installation/ubuntulinux.md', 'Installation', 'Ubuntu']
 - ['installation/rhel.md', 'Installation', 'Red Hat Enterprise Linux']
+- ['installation/centos.md', 'Installation', 'CentOS']
 - ['installation/debian.md', 'Installation', 'Debian']
 - ['installation/gentoolinux.md', 'Installation', 'Gentoo']
 - ['installation/google.md', 'Installation', 'Google Cloud Platform']

docs/sources/installation/centos.md

@@ -0,0 +1,89 @@
+page_title: Installation on CentOS
+page_description: Instructions for installing Docker on CentOS
+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
+> some binaries to be updated and published.
+
+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.
+
+    $ sudo yum install docker-io
+
+Now that it's installed, let's start the Docker daemon.
+
+    $ sudo service docker start
+
+If we want Docker to start at boot, we should also:
+
+    $ sudo chkconfig docker on
+
+Now let's verify that Docker is working. First we'll need to get the latest
+centos image.
+
+    $ sudo docker pull centos:latest
+
+Next we'll make sure that we can see the image by running:
+
+    $ sudo docker images centos
+
+This should generate some output similar to:
+
+    $ sudo docker images centos
+    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:     
+
+    $ sudo docker run -i -t centos /bin/bash
+
+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
+[CentOS bug tracker](http://bugs.centos.org).