github.com/brianfoshee/docker@v1.6.0/docs/sources/installation/centos.md (about) 1 page_title: Installation on CentOS 2 page_description: Instructions for installing Docker on CentOS 3 page_keywords: Docker, Docker documentation, requirements, linux, centos, epel, docker.io, docker-io 4 5 # CentOS 6 7 Docker is supported on the following versions of CentOS: 8 9 - [*CentOS 7 (64-bit)*](#installing-docker-centos-7) 10 - [*CentOS 6.5 (64-bit)*](#installing-docker-centos-6.5) or later 11 12 These instructions are likely work for other binary compatible EL6/EL7 distributions 13 such as Scientific Linux, but they haven't been tested. 14 15 Please note that due to the current Docker limitations, Docker is able to 16 run only on the **64 bit** architecture. 17 18 ## Kernel support 19 20 Currently the CentOS project will only support Docker when running on kernels 21 shipped by the distribution. There are kernel changes which will cause issues 22 if one decides to step outside that box and run non-distribution kernel packages. 23 24 To run Docker on [CentOS-6.5](http://www.centos.org) or later, you will need 25 kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow 26 Docker to run. 27 28 ## Installing Docker - CentOS-7 29 Docker is included by default in the CentOS-Extras repository. To install 30 run the following command: 31 32 $ sudo yum install docker 33 34 Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). 35 36 ### FirewallD 37 38 CentOS-7 introduced firewalld, which is a wrapper around iptables and can 39 conflict with Docker. 40 41 When `firewalld` is started or restarted it will remove the `DOCKER` chain 42 from iptables, preventing Docker from working properly. 43 44 When using Systemd, `firewalld` is started before Docker, but if you 45 start or restart `firewalld` after Docker, you will have to restart the Docker daemon. 46 47 ## Installing Docker - CentOS-6.5 48 49 For CentOS-6.5, the Docker package is part of [Extra Packages 50 for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository, 51 a community effort to create and maintain additional packages for the RHEL distribution. 52 53 Firstly, you need to ensure you have the EPEL repository enabled. Please 54 follow the [EPEL installation instructions]( 55 https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). 56 57 For CentOS-6, there is a package name conflict with a system tray application 58 and its executable, so the Docker RPM package was called `docker-io`. 59 60 To proceed with `docker-io` installation on CentOS-6, you may need to remove the 61 `docker` package first. 62 63 $ sudo yum -y remove docker 64 65 Next, let's install the `docker-io` package which will install Docker on our host. 66 67 $ sudo yum install docker-io 68 69 Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). 70 71 ## Manual installation of latest Docker release 72 73 While using a package is the recommended way of installing Docker, 74 the above package might not be the current release version. If you need the latest 75 version, [you can install the binary directly]( 76 https://docs.docker.com/installation/binaries/). 77 78 When installing the binary without a package, you may want 79 to integrate Docker with Systemd. For this, install the two unit files 80 (service and socket) from [the GitHub 81 repository](https://github.com/docker/docker/tree/master/contrib/init/systemd) 82 to `/etc/systemd/system`. 83 84 Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). 85 86 ## Starting the Docker daemon 87 88 Once Docker is installed, you will need to start the docker daemon. 89 90 $ sudo service docker start 91 92 If we want Docker to start at boot, we should also: 93 94 $ sudo chkconfig docker on 95 96 Now let's verify that Docker is working. First we'll need to get the latest 97 `centos` image. 98 99 $ sudo docker pull centos 100 101 Next we'll make sure that we can see the image by running: 102 103 $ sudo docker images centos 104 105 This should generate some output similar to: 106 107 $ sudo docker images centos 108 REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 109 centos latest 0b443ba03958 2 hours ago 297.6 MB 110 111 Run a simple bash shell to test the image: 112 113 $ sudo docker run -i -t centos /bin/bash 114 115 If everything is working properly, you'll get a simple bash prompt. Type 116 `exit` to continue. 117 118 ## Custom daemon options 119 120 If you need to add an HTTP Proxy, set a different directory or partition for the 121 Docker runtime files, or make other customizations, read our Systemd article to 122 learn how to [customize your Systemd Docker daemon options](/articles/systemd/). 123 124 ## Dockerfiles 125 The CentOS Project provides a number of sample Dockerfiles which you may use 126 either as templates or to familiarize yourself with docker. These templates 127 are available on GitHub at [https://github.com/CentOS/CentOS-Dockerfiles]( 128 https://github.com/CentOS/CentOS-Dockerfiles) 129 130 **Done!** You can either continue with the [Docker User 131 Guide](/userguide/) or explore and build on the images yourself. 132 133 ## Issues? 134 135 If you have any issues - please report them directly in the 136 [CentOS bug tracker](http://bugs.centos.org).