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