moby--moby/docs/sources/installation/rhel.md

page_title: Installation on Red Hat Enterprise Linux page_description: Installation instructions for Docker on Red Hat Enterprise Linux. page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos

Red Hat Enterprise Linux 7

Red Hat Enterprise Linux 7 has shipped with Docker. An overview and some guidance can be found in the Release Notes.

Docker is located in the extras channel. To install Docker:

1. Enable the extras channel:

    $ sudo subscription-manager repos --enable=rhel-7-server-extras-rpms
   

2. Install Docker:

    $ sudo yum install docker 
   

Additional installation, configuration, and usage information, including a Get Started with Docker Containers in Red Hat Enterprise Linux 7 guide, can be found by Red Hat customers on the Red Hat Customer Portal.

Red Hat Enterprise Linux 6

Docker is available for RHEL on EPEL. Please note that this package is part of Extra Packages for Enterprise Linux (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.

You will need RHEL 6.5 or higher, with a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow Docker to work.

Installation

Firstly, you need to install the EPEL repository. Please follow the EPEL installation instructions.

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 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 -y install docker-io

To update the docker-io package

$ sudo yum -y update 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.

$ sudo docker run -i -t fedora /bin/bash

Note: If you get a Cannot start container error mentioning SELinux or permission denied, you may need to update the SELinux policies. This can be done using sudo yum upgrade selinux-policy and then rebooting.

Done!

Continue with the User Guide.

Custom daemon options

If you need to add an HTTP Proxy, set a different directory or partition for the Docker runtime files, or make other customizations, read our systemd article to learn how to customize your systemd Docker daemon options.

Issues?

If you have any issues - please report them directly in the Red Hat Bugzilla for docker-io component.