github.com/guilhermebr/docker@v1.4.2-0.20150428121140-67da055cebca/docs/sources/installation/rhel.md (about)

     1  page_title: Installation on Red Hat Enterprise Linux
     2  page_description: Instructions for installing Docker on Red Hat Enterprise Linux.
     3  page_keywords: Docker, Docker documentation, requirements, linux, rhel
     4  
     5  # Red Hat Enterprise Linux
     6  
     7  Docker is supported on the following versions of RHEL:
     8  
     9  - [*Red Hat Enterprise Linux 7 (64-bit)*](#red-hat-enterprise-linux-7-installation)
    10  - [*Red Hat Enterprise Linux 6.5 (64-bit)*](#red-hat-enterprise-linux-6.5-installation) or later
    11  
    12  ## Kernel support
    13  
    14  RHEL will only support Docker via the *extras* channel or EPEL package when
    15  running on kernels shipped by the distribution. There are kernel changes which
    16  will cause issues if one decides to step outside that box and run
    17  non-distribution kernel packages.
    18  
    19  ## Red Hat Enterprise Linux 7 installation
    20  
    21  **Red Hat Enterprise Linux 7 (64 bit)** has [shipped with
    22  Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers).
    23  An overview and some guidance can be found in the [Release
    24  Notes](https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.0_Release_Notes/chap-Red_Hat_Enterprise_Linux-7.0_Release_Notes-Linux_Containers_with_Docker_Format.html).
    25  
    26  Docker is located in the *extras* channel. To install Docker:
    27  
    28  1. Enable the *extras* channel:
    29  
    30          $ sudo subscription-manager repos --enable=rhel-7-server-extras-rpms
    31  
    32  2. Install Docker:
    33  
    34          $ sudo yum install docker 
    35  
    36  Additional installation, configuration, and usage information,
    37  including a [Get Started with Docker Containers in Red Hat
    38  Enterprise Linux 7](https://access.redhat.com/site/articles/881893)
    39  guide, can be found by Red Hat customers on the [Red Hat Customer
    40  Portal](https://access.redhat.com/).
    41  
    42  Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
    43  
    44  ## Red Hat Enterprise Linux 6.5 installation
    45  
    46  You will need **64 bit** [RHEL
    47  6.5](https://access.redhat.com/site/articles/3078#RHEL6) or later, with
    48  a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel
    49  fixes to allow Docker to work.
    50  
    51  Docker is available for **RHEL6.5** on EPEL. Please note that
    52  this package is part of [Extra Packages for Enterprise Linux
    53  (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
    54  create and maintain additional packages for the RHEL distribution.
    55  
    56  ### Kernel support
    57  
    58  RHEL will only support Docker via the *extras* channel or EPEL package when
    59  running on kernels shipped by the distribution. There are things like namespace
    60  changes which will cause issues if one decides to step outside that box and run
    61  non-distro kernel packages.
    62  
    63  > **Warning**:
    64  > Please keep your system up to date using `yum update` and rebooting
    65  > your system. Keeping your system updated ensures critical security
    66  >  vulnerabilities and severe bugs (such as those found in kernel 2.6.32)
    67  > are fixed.
    68  
    69  ## Installation
    70  
    71  Firstly, you need to install the EPEL repository. Please follow the
    72  [EPEL installation
    73  instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
    74  
    75  There is a package name conflict with a system tray application
    76  and its executable, so the Docker RPM package was called `docker-io`.
    77  
    78  To proceed with `docker-io` installation, you may need to remove the
    79  `docker` package first.
    80  
    81      $ sudo yum -y remove docker
    82  
    83  Next, let's install the `docker-io` package which will install Docker on our host.
    84  
    85      $ sudo yum install docker-io
    86  
    87  To update the `docker-io` package
    88  
    89      $ sudo yum -y update docker-io
    90  
    91  Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
    92  
    93  ## Starting the Docker daemon
    94  
    95  Now that it's installed, let's start the Docker daemon.
    96  
    97      $ sudo service docker start
    98  
    99  If we want Docker to start at boot, we should also:
   100  
   101      $ sudo chkconfig docker on
   102  
   103  Now let's verify that Docker is working.
   104  
   105      $ sudo docker run -i -t fedora /bin/bash
   106  
   107  > Note: If you get a `Cannot start container` error mentioning SELinux
   108  > or permission denied, you may need to update the SELinux policies.
   109  > This can be done using `sudo yum upgrade selinux-policy` and then rebooting.
   110  
   111  **Done!**
   112  
   113  Continue with the [User Guide](/userguide/).
   114  
   115  ## Custom daemon options
   116  
   117  If you need to add an HTTP Proxy, set a different directory or partition for the
   118  Docker runtime files, or make other customizations, read our Systemd article to
   119  learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
   120  
   121  
   122  ## Issues?
   123  
   124  If you have any issues - please report them directly in the
   125  [Red Hat Bugzilla for docker-io component](
   126  https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora%20EPEL&component=docker-io).