@@ -5,18 +5,15 @@ description = "Instructions for installing Docker on CentOS"

 keywords = ["Docker, Docker documentation, requirements, linux, centos, epel, docker.io,  docker-io"]

 [menu.main]

 parent = "smn_linux"

+weight=-4

 +++

 <![end-metadata]-->

 # CentOS

-Docker is supported on the following versions of CentOS:

-

-* CentOS 7.X 

-

-Installation on other binary compatible EL7 distributions such as Scientific

-Linux might succeed, but Docker does not test or support Docker on these

-distributions.

+Docker runs on CentOS 7.X. An installation on other binary compatible EL7

+distributions such as Scientific Linux might succeed, but Docker does not test

+or support Docker on these distributions.

 This page instructs you to install using Docker-managed release packages and

 installation mechanisms. Using these packages ensures you get the latest release

@@ -31,7 +28,7 @@ your kernel must be 3.10 at minimum, which CentOS 7 runs.

 To check your current kernel version, open a terminal and use `uname -r` to

 display your kernel version:

-    $ uname -r 

+    $ uname -r

     3.10.0-229.el7.x86_64

 Finally, is it recommended that you fully update your system. Please keep in

@@ -41,66 +38,20 @@ packages.

 ## Install

-There are two ways to install Docker Engine.  You can use `curl` with the  `get.docker.com` site. This method runs an installation script which installs via the `yum` package manager. Or you can install with the `yum` package manager directly yourself.

-

-### Install with the script

+There are two ways to install Docker Engine.  You can install using the `yum`

+package manager. Or you can use `curl` with the  `get.docker.com` site. This

+second method runs an installation script which also installs via the `yum`

+package manager.

-

-1. Log into your machine as a user with `sudo` or `root` privileges.

-

-2. Make sure your existing yum packages are up-to-date.

-

-		$ sudo yum update

-		

-3. Run the Docker installation script.

-		

-		$ curl -sSL https://get.docker.com/ | sh

-		

-		This script adds the `docker.repo` repository and installs Docker.

-

-4. Start the Docker daemon.

-

-		$ sudo service docker start

-

-5. Verify `docker` is installed correctly by running a test image in a container.

-

-		$ sudo docker run hello-world

-		Unable to find image 'hello-world:latest' locally

-		latest: Pulling from hello-world

-		a8219747be10: Pull complete 

-		91c95931e552: Already exists 

-		hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.

-		Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d

-		Status: Downloaded newer image for hello-world:latest

-		Hello from Docker.

-		This message shows that your installation appears to be working correctly.

-

-		To generate this message, Docker took the following steps:

-		 1. The Docker client contacted the Docker daemon.

-		 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.

-				(Assuming it was not already locally available.)

-		 3. The Docker daemon created a new container from that image which runs the

-				executable that produces the output you are currently reading.

-		 4. The Docker daemon streamed that output to the Docker client, which sent it

-				to your terminal.

-

-		To try something more ambitious, you can run an Ubuntu container with:

-		 $ docker run -it ubuntu bash

-

-		For more examples and ideas, visit:

-		 http://docs.docker.com/userguide/

-

-### Install without the script

+### Install with yum

 1. Log into your machine as a user with `sudo` or `root` privileges.

 2. Make sure your existing yum packages are up-to-date.

         $ sudo yum update

-    

-3. Add the yum repo yourself.

-    For CentOS 7 run:

+3. Add the yum repo.

         $ cat >/etc/yum.repos.d/docker.repo <<-EOF

         [dockerrepo]

@@ -114,7 +65,7 @@ There are two ways to install Docker Engine.  You can use `curl` with the  `get.

 4. Install the Docker package.

         $ sudo yum install docker-engine

-        

+

 5. Start the Docker daemon.

         $ sudo service docker start

@@ -122,7 +73,55 @@ There are two ways to install Docker Engine.  You can use `curl` with the  `get.

 6. Verify `docker` is installed correctly by running a test image in a container.

         $ sudo docker run hello-world

- 

+        Unable to find image 'hello-world:latest' locally

+    		latest: Pulling from hello-world

+    		a8219747be10: Pull complete

+    		91c95931e552: Already exists

+    		hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.

+    		Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d

+    		Status: Downloaded newer image for hello-world:latest

+    		Hello from Docker.

+    		This message shows that your installation appears to be working correctly.

+

+    		To generate this message, Docker took the following steps:

+    		 1. The Docker client contacted the Docker daemon.

+    		 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.

+    				(Assuming it was not already locally available.)

+    		 3. The Docker daemon created a new container from that image which runs the

+    				executable that produces the output you are currently reading.

+    		 4. The Docker daemon streamed that output to the Docker client, which sent it

+    				to your terminal.

+

+    		To try something more ambitious, you can run an Ubuntu container with:

+    		 $ docker run -it ubuntu bash

+

+    		For more examples and ideas, visit:

+    		 http://docs.docker.com/userguide/

+

+### Install with the script

+

+

+1. Log into your machine as a user with `sudo` or `root` privileges.

+

+2. Make sure your existing yum packages are up-to-date.

+

+		$ sudo yum update

+

+3. Run the Docker installation script.

+

+		$ curl -sSL https://get.docker.com/ | sh

+

+	This script adds the `docker.repo` repository and installs Docker.

+

+4. Start the Docker daemon.

+

+		$ sudo service docker start

+

+5. Verify `docker` is installed correctly by running a test image in a container.

+

+		$ sudo docker run hello-world

+

+

 ## Create a docker group		

 The `docker` daemon binds to a Unix socket instead of a TCP port. By default

@@ -152,7 +151,7 @@ To create the `docker` group and add your user:

 4. Verify your work by running `docker` without `sudo`.

 		$ docker run hello-world

- 

+

 ## Start the docker daemon at boot

 To ensure Docker starts when you boot your system, do the following:

@@ -172,15 +171,14 @@ You can uninstall the Docker software with `yum`.

 		$ yum list installed | grep docker

 		yum list installed | grep docker

-		docker-engine.x86_64                1.7.1-1.el7

-																																								 @/docker-engine-1.7.1-1.el7.x86_64.rpm

+		docker-engine.x86_64   1.7.1-1.el7 @/docker-engine-1.7.1-1.el7.x86_64.rpm

 2. Remove the package.

-		$ sudo yum -y remove docker-engine.x86_64 

+		$ sudo yum -y remove docker-engine.x86_64

 	This command does not remove images, containers, volumes, or user-created

-	configuration files on your host. 

+	configuration files on your host.

 3. To delete all images, containers, and volumes, run the following command:

@@ -5,6 +5,7 @@ description = "Instructions for installing Docker on Debian."

 keywords = ["Docker, Docker documentation, installation,  debian"]

 [menu.main]

 parent = "smn_linux"

+weight=-2

 +++

 <![end-metadata]-->

@@ -12,113 +13,98 @@ parent = "smn_linux"

 Docker is supported on the following versions of Debian:

+ - [*Debian testing stretch (64-bit)*](#debian-wheezy-stable-7-x-64-bit)

  - [*Debian 8.0 Jessie (64-bit)*](#debian-jessie-80-64-bit)

  - [*Debian 7.7 Wheezy (64-bit)*](#debian-wheezy-stable-7-x-64-bit)

-## Debian Jessie 8.0 (64-bit)

+ >**Note**: If you previously installed Docker using `apt`, make sure you update

+ your `apt` sources to the new `apt` repository.

-Debian 8 comes with a 3.16.0 Linux kernel, the `docker.io` package can be found in the `jessie-backports` repository. Reasoning behind this can be found <a href="https://lists.debian.org/debian-release/2015/03/msg00685.html" target="_blank">here</a>. Instructions how to enable the backports repository can be found <a href="http://backports.debian.org/Instructions/" target="_blank">here</a>.

+## Prerequisites

-> **Note**:

-> Debian contains a much older KDE3/GNOME2 package called ``docker``, so the

-> package and the executable are called ``docker.io``.

+ Docker requires a 64-bit installation regardless of your Debian version.

+ Additionally, your kernel must be 3.10 at minimum. The latest 3.10 minor

+ version or a newer maintained version are also acceptable.

-### Installation

+ Kernels older than 3.10 lack some of the features required to run Docker

+ containers. These older versions are known to have bugs which cause data loss

+ and frequently panic under certain conditions.

-Make sure you enabled the `jessie-backports` repository, as stated above.

+ To check your current kernel version, open a terminal and use `uname -r` to

+ display your kernel version:

-To install the latest Debian package (may not be the latest Docker release):

+     $ uname -r

-    $ sudo apt-get update

-    $ sudo apt-get install docker.io

+### Update your apt repository

-To verify that everything has worked as expected:

+Docker's `apt` repository contains Docker 1.7.1 and higher. To set `apt` to use

+from the new repository:

-    $ sudo docker run --rm hello-world

+ 1. If you haven't already done so, log into your machine as a user with `sudo` or `root` privileges.

-This command downloads and runs the `hello-world` image in a container. When the

-container runs, it prints an informational message. Then, it exits.

+ 2. Open a terminal window.

-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](/articles/systemd/).

+ 3. Purge any older repositories.

-> **Note**:

-> If you want to enable memory and swap accounting see

-> [this](/installation/ubuntulinux/#adjust-memory-and-swap-accounting).

+         $ apt-get purge lxc-docker*

+         $ apt-get purge docker.io*

-### Uninstallation

+ 4. Add the new `gpg` key.

-To uninstall the Docker package:

-

-    $ sudo apt-get purge docker.io

-

-To uninstall the Docker package and dependencies that are no longer needed:

-

-    $ sudo apt-get autoremove --purge docker.io

+         $ apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D

-The above commands will not remove images, containers, volumes, or user created

-configuration files on your host. If you wish to delete all images, containers,

-and volumes run the following command:

+ 5. Open the `/etc/apt/sources.list.d/docker.list` file in your favorite editor.

-    $ rm -rf /var/lib/docker

+     If the file doesn't exist, create it.

-You must delete the user created configuration files manually.

+ 6. Remove any existing entries.

-## Debian Wheezy/Stable 7.x (64-bit)

+ 7. Add an entry for your Debian operating system.

-Docker requires Kernel 3.8+, while Wheezy ships with Kernel 3.2 (for more details

-on why 3.8 is required, see discussion on

-[bug #407](https://github.com/docker/docker/issues/407)).

+     The possible entries are:

-Fortunately, wheezy-backports currently has [Kernel 3.16

-](https://packages.debian.org/search?suite=wheezy-backports&section=all&arch=any&searchon=names&keywords=linux-image-amd64),

-which is officially supported by Docker.

+         # Debian Wheezy

+        deb https://apt.dockerproject.org/repo debian-wheezy main

+        # Debian Jessie

+        deb https://apt.dockerproject.org/repo debian-jessie main

+        # Debian Stretch/Sid

+        deb https://apt.dockerproject.org/repo debian-stretch main

-### Installation

+ 8. Save and close the file.

-1. Install Kernel from wheezy-backports

+ 9. Update the `apt` package index.

-    Add the following line to your `/etc/apt/sources.list`

+         $ apt-get update

-    `deb http://http.debian.net/debian wheezy-backports main`

+ 10. Verify that `apt` is pulling from the right repository.

-    then install the `linux-image-amd64` package (note the use of

-    `-t wheezy-backports`)

+         $ apt-cache policy docker-engine

-        $ sudo apt-get update

-        $ sudo apt-get install -t wheezy-backports linux-image-amd64

+     From now on when you run `apt-get upgrade`, `apt` pulls from the new apt repository.  

-2. Restart your system. This is necessary for Debian to use your new kernel.

+## Install Docker

-3. Install Docker using the get.docker.com script:

+Before installing Docker, make sure you have set your `apt` repository correctly as described in the prerequisites.

-    `curl -sSL https://get.docker.com/ | sh`

+1. Update the `apt` package index.

->**Note**: If your company is behind a filtering proxy, you may find that the

->`apt-key`

->command fails for the Docker repo during installation. To work around this,

->add the key directly using the following:

->

->       $ curl -sSL https://get.docker.com/gpg | sudo apt-key add -

+        $ sudo apt-get update

-### Uninstallation

+2. Install Docker.

-To uninstall the Docker package:

+        $ sudo apt-get install docker-engine

-    $ sudo apt-get purge docker-engine

+5. Start the `docker` daemon.

-To uninstall the Docker package and dependencies that are no longer needed:

+        $ sudo service docker start

-    $ sudo apt-get autoremove --purge docker-engine

+6. Verify `docker` is installed correctly.

-The above commands will not remove images, containers, volumes, or user created

-configuration files on your host. If you wish to delete all images, containers,

-and volumes run the following command:

+        $ sudo docker run hello-world

-    $ rm -rf /var/lib/docker

+    This command downloads a test image and runs it in a container. When the

+    container runs, it prints an informational message. Then, it exits.

-You must delete the user created configuration files manually.

 ## Giving non-root access

@@ -154,6 +140,29 @@ use the `-G` flag to specify an alternative group.

     # Restart the Docker daemon.

     $ sudo service docker restart

+## Upgrade Docker

+

+To install the latest version of Docker with `apt-get`:

+

+    $ apt-get upgrade docker-engine

+

+## Uninstall

+

+To uninstall the Docker package:

+

+    $ sudo apt-get purge docker-engine

+

+To uninstall the Docker package and dependencies that are no longer needed:

+

+    $ sudo apt-get autoremove --purge docker-engine

+

+The above commands will not remove images, containers, volumes, or user created

+configuration files on your host. If you wish to delete all images, containers,

+and volumes run the following command:

+

+    $ rm -rf /var/lib/docker

+

+You must delete the user created configuration files manually.

 ## What next?

@@ -5,108 +5,47 @@ description = "Instructions for installing Docker on Fedora."

 keywords = ["Docker, Docker documentation, Fedora, requirements,  linux"]

 [menu.main]

 parent = "smn_linux"

+weight=-3

 +++

 <![end-metadata]-->

 # Fedora

-Docker is supported on the following versions of Fedora:

-

-- Fedora 21

-- Fedora 22 

-

-This page instructs you to install using Docker-managed release packages and

-installation mechanisms. Using these packages ensures you get the latest release

-of Docker. If you wish to install using Fedora-managed packages, consult your

-Fedora release documentation for information on Fedora's Docker support.

+Docker is supported Fedora version 21 and 22. This page instructs you to install

+using Docker-managed release packages and installation mechanisms. Using these

+packages ensures you get the latest release of Docker. If you wish to install

+using Fedora-managed packages, consult your Fedora release documentation for

+information on Fedora's Docker support.

 ## Prerequisites

 Docker requires a 64-bit installation regardless of your Fedora version. Also, your kernel must be 3.10 at minimum. To check your current kernel

 version, open a terminal and use `uname -r` to display your kernel version:

-    $ uname -r 

-    3.19.5-100.fc20.x86_64

+    $ uname -r

+    3.19.5-100.fc21.x86_64

 If your kernel is at a older version, you must update it.

 Finally, is it recommended that you fully update your system. Please keep in

 mind that your system should be fully patched to fix any potential kernel bugs. Any

-reported kernel bugs may have already been fixed on the latest kernel packages 

+reported kernel bugs may have already been fixed on the latest kernel packages

 ## Install

-There are two ways to install Docker Engine.  You can use `curl` with the  `get.docker.com` site. This method runs an installation script which installs via the `yum` package manager. Or you can install with the `yum` package manager directly yourself.

-

-### Install with the script

+There are two ways to install Docker Engine.  You can install with the `yum` package manager. Or you can use `curl` with the  `get.docker.com` site. This second method runs an installation script which also installs via the `yum` package manager.

+### Install with yum

 1. Log into your machine as a user with `sudo` or `root` privileges.

 2. Make sure your existing yum packages are up-to-date.

 		$ sudo yum update

-		

-3. Run the Docker installation script.

-		

-		$ curl -sSL https://get.docker.com/ | sh

-		

-		This script adds the `docker.repo` repository and installs Docker.

-

-4. Start the Docker daemon.

-		$ sudo service docker start

-

-5. Verify `docker` is installed correctly by running a test image in a container.

-

-		$ sudo docker run hello-world

-		Unable to find image 'hello-world:latest' locally

-		latest: Pulling from hello-world

-		a8219747be10: Pull complete 

-		91c95931e552: Already exists 

-		hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.

-		Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d

-		Status: Downloaded newer image for hello-world:latest

-		Hello from Docker.

-		This message shows that your installation appears to be working correctly.

-

-		To generate this message, Docker took the following steps:

-		 1. The Docker client contacted the Docker daemon.

-		 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.

-				(Assuming it was not already locally available.)

-		 3. The Docker daemon created a new container from that image which runs the

-				executable that produces the output you are currently reading.

-		 4. The Docker daemon streamed that output to the Docker client, which sent it

-				to your terminal.

-

-		To try something more ambitious, you can run an Ubuntu container with:

-		 $ docker run -it ubuntu bash

-

-		For more examples and ideas, visit:

-		 http://docs.docker.com/userguide/

-

-### Install without the script

-

-1. Log into your machine as a user with `sudo` or `root` privileges.

-

-2. Make sure your existing yum packages are up-to-date.

-

-		$ sudo yum update

-    

 3. Add the yum repo yourself.

-    For Fedora 20 run:

-

-        $ cat >/etc/yum.repos.d/docker.repo <<-EOF

-        [dockerrepo]

-        name=Docker Repository

-        baseurl=https://yum.dockerproject.org/repo/main/fedora/20

-        enabled=1

-        gpgcheck=1

-        gpgkey=https://yum.dockerproject.org/gpg

-        EOF

-

     For Fedora 21 run:

         $ cat >/etc/yum.repos.d/docker.repo <<-EOF

@@ -132,15 +71,64 @@ There are two ways to install Docker Engine.  You can use `curl` with the  `get.

 4. Install the Docker package.

         $ sudo yum install docker-engine

-        

+

 5. Start the Docker daemon.

 		$ sudo service docker start

 6. Verify `docker` is installed correctly by running a test image in a container.

+

+        $ sudo docker run hello-world

+        Unable to find image 'hello-world:latest' locally

+        latest: Pulling from hello-world

+        a8219747be10: Pull complete

+        91c95931e552: Already exists

+        hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.

+        Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd1.7.1cf5daeb82aab55838d

+        Status: Downloaded newer image for hello-world:latest

+        Hello from Docker.

+        This message shows that your installation appears to be working correctly.

+

+        To generate this message, Docker took the following steps:

+         1. The Docker client contacted the Docker daemon.

+         2. The Docker daemon pulled the "hello-world" image from the Docker Hub.

+            (Assuming it was not already locally available.)

+         3. The Docker daemon created a new container from that image which runs the

+            executable that produces the output you are currently reading.

+         4. The Docker daemon streamed that output to the Docker client, which sent it

+            to your terminal.

+

+        To try something more ambitious, you can run an Ubuntu container with:

+         $ docker run -it ubuntu bash

+

+        For more examples and ideas, visit:

+         http://docs.docker.com/userguide/

+

+

+### Install with the script

+

+

+1. Log into your machine as a user with `sudo` or `root` privileges.

+

+2. Make sure your existing yum packages are up-to-date.

+

+		$ sudo yum update

+

+3. Run the Docker installation script.

+

+		$ curl -sSL https://get.docker.com/ | sh

+

+	This script adds the `docker.repo` repository and installs Docker.

+

+4. Start the Docker daemon.

+

+		$ sudo service docker start

+

+5. Verify `docker` is installed correctly by running a test image in a container.

+

 		$ sudo docker run hello-world

- 

+

 ## Create a docker group		

 The `docker` daemon binds to a Unix socket instead of a TCP port. By default

@@ -170,31 +158,7 @@ To create the `docker` group and add your user:

 4. Verify your work by running `docker` without `sudo`.

         $ docker run hello-world

-				Unable to find image 'hello-world:latest' locally

-				latest: Pulling from hello-world

-				a8219747be10: Pull complete 

-				91c95931e552: Already exists 

-				hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.

-				Digest: sha256:aa03e5d0d5553b4c3473e89c8619cf79df368babd18681cf5daeb82aab55838d

-				Status: Downloaded newer image for hello-world:latest

-				Hello from Docker.

-				This message shows that your installation appears to be working correctly.

-

-				To generate this message, Docker took the following steps:

-				 1. The Docker client contacted the Docker daemon.

-				 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.

-						(Assuming it was not already locally available.)

-				 3. The Docker daemon created a new container from that image which runs the

-						executable that produces the output you are currently reading.

-				 4. The Docker daemon streamed that output to the Docker client, which sent it

-						to your terminal.

-

-				To try something more ambitious, you can run an Ubuntu container with:

-				 $ docker run -it ubuntu bash

-

-				For more examples and ideas, visit:

-				 http://docs.docker.com/userguide/

- 

+

 ## Start the docker daemon at boot

 To ensure Docker starts when you boot your system, do the following:

@@ -230,17 +194,15 @@ You can uninstall the Docker software with `yum`.

 1. List the package you have installed.

-		$ yum list installed | grep docker

-		yum list installed | grep docker

-		docker-engine.x86_64                1.7.1-0.1.fc20

-																																								 @/docker-engine-1.7.1-0.1.fc20.el7.x86_64

+		$ yum list installed | grep docker yum list installed | grep docker

+		docker-engine.x86_64     1.7.1-0.1.fc21 @/docker-engine-1.7.1-0.1.fc21.el7.x86_64

 2. Remove the package.

-		$ sudo yum -y remove docker-engine.x86_64 

+		$ sudo yum -y remove docker-engine.x86_64

 	This command does not remove images, containers, volumes, or user-created

-	configuration files on your host. 

+	configuration files on your host.

 3. To delete all images, containers, and volumes, run the following command:

@@ -8,86 +8,143 @@ parent = "smn_linux"

 +++

 <![end-metadata]-->

-# Oracle Linux 6 and 7

+# Oracle Linux

-You do not require an Oracle Linux Support subscription to install Docker on

-Oracle Linux.

+Docker is supported Oracle Linux 6 and 7. You do not require an Oracle Linux

+Support subscription to install Docker on Oracle Linux.

-*For Oracle Linux customers with an active support subscription:*

-Docker is available in either the `ol6_x86_64_addons` or `ol7_x86_64_addons`

-channel for Oracle Linux 6 and Oracle Linux 7 on the [Unbreakable Linux Network

-(ULN)](https://linux.oracle.com).

+This page instructs you to install using Docker-managed release packages and

+installation mechanisms. Using these packages ensures you get the latest release

+of Docker. If you wish to install using Oracle-managed packages, consult your

+[Oracle Linux documentation](https://linux.oracle.com).

-*For Oracle Linux users without an active support subscription:*

-Docker is available in the appropriate `ol6_addons` or `ol7_addons` repository

-on [Oracle Public Yum](http://public-yum.oracle.com).

-Docker requires the use of the Unbreakable Enterprise Kernel Release 3 (3.8.13)

-or higher on Oracle Linux. This kernel supports the Docker btrfs storage engine

-on both Oracle Linux 6 and 7.

+## Prerequisites

 Due to current Docker limitations, Docker is only able to run only on the x86_64

-architecture.

+architecture. Docker requires the use of the Unbreakable Enterprise Kernel

+Release 3 (3.8.13) or higher on Oracle Linux. This kernel supports the Docker

+btrfs storage engine on both Oracle Linux 6 and 7.

-## To enable the *addons* channel via the Unbreakable Linux Network:

-1. Enable either the *ol6\_x86\_64\_addons* or *ol7\_x86\_64\_addons* channel

-via the ULN web interface.

-Consult the [Unbreakable Linux Network User's

-Guide](http://docs.oracle.com/cd/E52668_01/E39381/html/index.html) for

-documentation on subscribing to channels.

-## To enable the *addons* repository via Oracle Public Yum:

+## Install

-The latest release of Oracle Linux 6 and 7 are automatically configured to use

-the Oracle Public Yum repositories during installation. However, the *addons*

-repository is not enabled by default.

+1. Log into your machine as a user with `sudo` or `root` privileges.

-To enable the *addons* repository:

+2. Make sure your existing yum packages are up-to-date.

-1. Edit either `/etc/yum.repos.d/public-yum-ol6.repo` or

-`/etc/yum.repos.d/public-yum-ol7.repo`

-and set `enabled=1` in the `[ol6_addons]` or the `[ol7_addons]` stanza.

+        $ sudo yum update

-## Installation 

+3. Add the yum repo yourself.

-1. Ensure the appropriate *addons* channel or repository has been enabled.

+    For version 6:

-2. Use yum to install the Docker package:

+        $ cat >/etc/yum.repos.d/docker.repo <<-EOF

+        [dockerrepo]

+        name=Docker Repository

+        baseurl=https://yum.dockerproject.org/repo/main/oraclelinux/6

+        enabled=1

+        gpgcheck=1

+        gpgkey=https://yum.dockerproject.org/gpg

+        EOF

+

+    For version 7:

+

+        $ cat >/etc/yum.repos.d/docker.repo <<-EOF

+        [dockerrepo]

+        name=Docker Repository

+        baseurl=https://yum.dockerproject.org/repo/main/oraclelinux/7

+        enabled=1

+        gpgcheck=1

+        gpgkey=https://yum.dockerproject.org/gpg

+        EOF

+

+4. Install the Docker package.

         $ sudo yum install docker

-## Starting Docker 

+5. Start the Docker daemon.

+

+     On Oracle Linux 6:

+

+        $ sudo service docker start

+

+     On Oracle Linux 7:

+

+        $ sudo systemctl start docker.service

+

+6. Verify `docker` is installed correctly by running a test image in a container.

+

+        $ sudo docker run hello-world

+

+## Optional configurations

+

+This section contains optional procedures for configuring your Oracle Linux to work

+better with Docker.

-1. Now that it's installed, start the Docker daemon:

+* [Create a docker group](#create-a-docker-group)

+* [Configure Docker to start on boot](#configure-docker-to-start-on-boot)

+* [Use the btrfs storage engine](#use-the-btrfs-storage-engine)

-    1. On Oracle Linux 6:

+### Create a Docker group		

-            $ sudo service docker start

+The `docker` daemon binds to a Unix socket instead of a TCP port. By default

+that Unix socket is owned by the user `root` and other users can access it with

+`sudo`. For this reason, `docker` daemon always runs as the `root` user.

-    2. On Oracle Linux 7:

+To avoid having to use `sudo` when you use the `docker` command, create a Unix

+group called `docker` and add users to it. When the `docker` daemon starts, it

+makes the ownership of the Unix socket read/writable by the `docker` group.

-            $ sudo systemctl start docker.service

+>**Warning**: The `docker` group is equivalent to the `root` user; For details

+>on how this impacts security in your system, see [*Docker Daemon Attack

+>Surface*](/articles/security/#docker-daemon-attack-surface) for details.

-2. If you want the Docker daemon to start automatically at boot:

+To create the `docker` group and add your user:

-    1. On Oracle Linux 6:

+1. Log into Oracle Linux as a user with `sudo` privileges.

-            $ sudo chkconfig docker on

+2. Create the `docker` group and add your user.

-    2. On Oracle Linux 7:

+        sudo usermod -aG docker username

-            $ sudo systemctl enable docker.service

+3. Log out and log back in.

-**Done!**

+    This ensures your user is running with the correct permissions.

-## Custom daemon options

+4. Verify your work by running `docker` without `sudo`.

+

+        $ docker run hello-world

+

+	If this fails with a message similar to this:

+

+		Cannot connect to the Docker daemon. Is 'docker daemon' running on this host?

+

+	Check that the `DOCKER_HOST` environment variable is not set for your shell.

+	If it is, unset it.

+

+### Configure Docker to start on boot

+

+You can configure the  Docker daemon to start automatically at boot.

+

+On Oracle Linux 6:

+

+```

+$ sudo chkconfig docker on

+```

+

+On Oracle Linux 7:

+

+```

+$ sudo systemctl enable docker.service

+```

 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](/articles/systemd/).

-## Using the btrfs storage engine

+### Use the btrfs storage engine

 Docker on Oracle Linux 6 and 7 supports the use of the btrfs storage engine.

 Before enabling btrfs support, ensure that `/var/lib/docker` is stored on a

@@ -100,10 +157,10 @@ on how to create and mount btrfs filesystems.

 To enable btrfs support on Oracle Linux:

 1. Ensure that `/var/lib/docker` is on a btrfs filesystem.

-1. Edit `/etc/sysconfig/docker` and add `-s btrfs` to the `OTHER_ARGS` field.

-2. Restart the Docker daemon:

-You can now continue with the [Docker User Guide](/userguide/).

+2. Edit `/etc/sysconfig/docker` and add `-s btrfs` to the `OTHER_ARGS` field.

+

+3. Restart the Docker daemon:

 ## Uninstallation

@@ -5,19 +5,17 @@ description = "Instructions for installing Docker on Red Hat Enterprise Linux."

 keywords = ["Docker, Docker documentation, requirements, linux,  rhel"]

 [menu.main]

 parent = "smn_linux"

+weight = -5

 +++

 <![end-metadata]-->

 # Red Hat Enterprise Linux

-Docker is supported on the following versions of RHEL:

-

-- Red Hat Enterprise Linux 7

-

-This page instructs you to install using Docker-managed release packages and

-installation mechanisms. Using these packages ensures you get the latest release

-of Docker. If you wish to install using Red Hat-managed packages, consult your

-Red Hat release documentation for information on Red Hat's Docker support.

+Docker is supported on Red Hat Enterprise Linux 7. This page instructs you to

+install using Docker-managed release packages and installation mechanisms. Using

+these packages ensures you get the latest release of Docker. If you wish to

+install using Red Hat-managed packages, consult your Red Hat release

+documentation for information on Red Hat's Docker support.

 ## Prerequisites

@@ -27,7 +25,7 @@ requires that your kernel must be 3.10 at minimum, which Red Hat 7 runs.

 To check your current kernel version, open a terminal and use `uname -r` to

 display your kernel version:

-    $ uname -r 

+    $ uname -r

     3.10.0-229.el7.x86_64