github.com/feiyang21687/docker@v1.5.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).