diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index e3f9e28196..1e6b8b16d8 100755 --- a/docs/mkdocs.yml +++ b/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'] diff --git a/docs/sources/installation/centos.md b/docs/sources/installation/centos.md new file mode 100644 index 0000000000..74d1ec858e --- /dev/null +++ b/docs/sources/installation/centos.md @@ -0,0 +1,89 @@ +page_title: Installation on CentOS +page_description: This page provides documentation 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: + + [your-user@lappy ~]# 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).