Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>
| ... | ... |
@@ -4,48 +4,34 @@ page_keywords: Docker, Docker documentation, requirements, linux, centos, epel, |
| 4 | 4 |
|
| 5 | 5 |
# CentOS |
| 6 | 6 |
|
| 7 |
-While the Docker package is provided by default as part of CentOS-7, |
|
| 8 |
-it is provided by the EPEL repository for CentOS-6. Please note that |
|
| 9 |
-this changes the installation instructions slightly between versions. If you |
|
| 10 |
-need the latest version, you can always use the latest binary which works on |
|
| 11 |
-kernel 3.8 and above. |
|
| 7 |
+Docker is supported on the following versions of CentOS: |
|
| 12 | 8 |
|
| 13 |
-These instructions work for CentOS 6 and later. They will likely work for |
|
| 14 |
-other binary compatible EL6 distributions such as Scientific Linux, but |
|
| 15 |
-they haven't been tested. |
|
| 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. |
|
| 16 | 14 |
|
| 17 | 15 |
Please note that due to the current Docker limitations, Docker is able to |
| 18 | 16 |
run only on the **64 bit** architecture. |
| 19 | 17 |
|
| 20 |
-To run Docker, you will need [CentOS6](http://www.centos.org) or higher, |
|
| 21 |
-with a kernel version 2.6.32-431 or higher as this has specific kernel |
|
| 22 |
-fixes to allow Docker to run. |
|
| 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. |
|
| 23 | 27 |
|
| 24 | 28 |
## Installing Docker - CentOS-7 |
| 25 | 29 |
Docker is included by default in the CentOS-Extras repository. To install |
| 26 |
-simply run the following command. |
|
| 30 |
+run the following command: |
|
| 27 | 31 |
|
| 28 | 32 |
$ sudo yum install docker |
| 29 | 33 |
|
| 30 |
-## Kernel support |
|
| 31 |
- |
|
| 32 |
-Currently the CentOS project will only support Docker via the EPEL package when |
|
| 33 |
-running on kernels shipped by the distribution. There are things like namespace |
|
| 34 |
-changes which will cause issues if one decides to step outside that box and run |
|
| 35 |
-non-distro kernel packages. |
|
| 36 |
- |
|
| 37 |
-### Manual installation of latest version |
|
| 38 |
- |
|
| 39 |
-While using a package is the recommended way of installing Docker, |
|
| 40 |
-the above package might not be the latest version. If you need the latest |
|
| 41 |
-version, [you can install the binary directly]( |
|
| 42 |
-https://docs.docker.com/installation/binaries/). |
|
| 43 |
- |
|
| 44 |
-When installing the binary without a package, you may want |
|
| 45 |
-to integrate Docker with systemd. For this, simply install the two unit files |
|
| 46 |
-(service and socket) from [the github |
|
| 47 |
-repository](https://github.com/docker/docker/tree/master/contrib/init/systemd) |
|
| 48 |
-to `/etc/systemd/system`. |
|
| 34 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 49 | 35 |
|
| 50 | 36 |
### FirewallD |
| 51 | 37 |
|
| ... | ... |
@@ -55,32 +41,49 @@ conflict with Docker. |
| 55 | 55 |
When `firewalld` is started or restarted it will remove the `DOCKER` chain |
| 56 | 56 |
from iptables, preventing Docker from working properly. |
| 57 | 57 |
|
| 58 |
-When using systemd, `firewalld` is started before Docker, but if you |
|
| 58 |
+When using Systemd, `firewalld` is started before Docker, but if you |
|
| 59 | 59 |
start or restart `firewalld` after Docker, you will have to restart the Docker daemon. |
| 60 | 60 |
|
| 61 |
-## Installing Docker - CentOS-6 |
|
| 62 |
-Please note that this for CentOS-6, this package is part of [Extra Packages |
|
| 63 |
-for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort |
|
| 64 |
-to create and maintain additional packages for the RHEL distribution. |
|
| 61 |
+## Installing Docker - CentOS-6.5 |
|
| 62 |
+ |
|
| 63 |
+For Centos-6.5, the Docker package is part of [Extra Packages |
|
| 64 |
+for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository, |
|
| 65 |
+a community effort to create and maintain additional packages for the RHEL distribution. |
|
| 65 | 66 |
|
| 66 | 67 |
Firstly, you need to ensure you have the EPEL repository enabled. Please |
| 67 | 68 |
follow the [EPEL installation instructions]( |
| 68 | 69 |
https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). |
| 69 | 70 |
|
| 70 |
-The `docker-io` package provides Docker on EPEL. |
|
| 71 |
+For CentOS-6, there is a package name conflict with a system tray application |
|
| 72 |
+and its executable, so the Docker RPM package was called `docker-io`. |
|
| 71 | 73 |
|
| 72 |
-If you already have the (unrelated) `docker` package |
|
| 73 |
-installed, it will conflict with `docker-io`. |
|
| 74 |
-There's a [bug report]( |
|
| 75 |
-https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it. |
|
| 76 |
-To proceed with `docker-io` installation, please remove `docker` first. |
|
| 74 |
+To proceed with `docker-io` installation on CentOS-6, you may need to remove the |
|
| 75 |
+`docker` package first. |
|
| 77 | 76 |
|
| 78 |
-Next, let's install the `docker-io` package which |
|
| 79 |
-will install Docker on our host. |
|
| 77 |
+ $ sudo yum -y remove docker |
|
| 78 |
+ |
|
| 79 |
+Next, let's install the `docker-io` package which will install Docker on our host. |
|
| 80 | 80 |
|
| 81 | 81 |
$ sudo yum install docker-io |
| 82 | 82 |
|
| 83 |
-## Using Docker |
|
| 83 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 84 |
+ |
|
| 85 |
+## Manual installation of latest Docker release |
|
| 86 |
+ |
|
| 87 |
+While using a package is the recommended way of installing Docker, |
|
| 88 |
+the above package might not be the current release version. If you need the latest |
|
| 89 |
+version, [you can install the binary directly]( |
|
| 90 |
+https://docs.docker.com/installation/binaries/). |
|
| 91 |
+ |
|
| 92 |
+When installing the binary without a package, you may want |
|
| 93 |
+to integrate Docker with Systemd. For this, install the two unit files |
|
| 94 |
+(service and socket) from [the GitHub |
|
| 95 |
+repository](https://github.com/docker/docker/tree/master/contrib/init/systemd) |
|
| 96 |
+to `/etc/systemd/system`. |
|
| 97 |
+ |
|
| 98 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 99 |
+ |
|
| 100 |
+## Starting the Docker daemon |
|
| 84 | 101 |
|
| 85 | 102 |
Once Docker is installed, you will need to start the docker daemon. |
| 86 | 103 |
|
| ... | ... |
@@ -115,13 +118,13 @@ If everything is working properly, you'll get a simple bash prompt. Type |
| 115 | 115 |
## Custom daemon options |
| 116 | 116 |
|
| 117 | 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/). |
|
| 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 | 120 |
|
| 121 | 121 |
## Dockerfiles |
| 122 | 122 |
The CentOS Project provides a number of sample Dockerfiles which you may use |
| 123 | 123 |
either as templates or to familiarize yourself with docker. These templates |
| 124 |
-are available on github at [https://github.com/CentOS/CentOS-Dockerfiles]( |
|
| 124 |
+are available on GitHub at [https://github.com/CentOS/CentOS-Dockerfiles]( |
|
| 125 | 125 |
https://github.com/CentOS/CentOS-Dockerfiles) |
| 126 | 126 |
|
| 127 | 127 |
**Done!** You can either continue with the [Docker User |
| ... | ... |
@@ -1,25 +1,19 @@ |
| 1 | 1 |
page_title: Installation on Fedora |
| 2 |
-page_description: Installation instructions for Docker on Fedora. |
|
| 3 |
-page_keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux |
|
| 2 |
+page_description: Instructions for installing Docker on Fedora. |
|
| 3 |
+page_keywords: Docker, Docker documentation, Fedora, requirements, linux |
|
| 4 | 4 |
|
| 5 | 5 |
# Fedora |
| 6 | 6 |
|
| 7 |
-Docker is supported only on Fedora 20 and later, |
|
| 8 |
-on the **64 bit** architecture. |
|
| 7 |
+Docker is supported on the following versions of Fedora: |
|
| 9 | 8 |
|
| 10 |
-## Installation |
|
| 9 |
+- [*Fedora 20 (64-bit)*](#fedora-20-installation) |
|
| 10 |
+- [*Fedora 21 and later (64-bit)*](#fedora-21-and-later-installation) |
|
| 11 | 11 |
|
| 12 |
-For `Fedora 20`, the `docker-io` package provides Docker. |
|
| 12 |
+Currently the Fedora project will only support Docker when running on kernels |
|
| 13 |
+shipped by the distribution. There are kernel changes which will cause issues |
|
| 14 |
+if one decides to step outside that box and run non-distribution kernel packages. |
|
| 13 | 15 |
|
| 14 |
-If you have the (unrelated) `docker` package installed already, it will |
|
| 15 |
-conflict with `docker-io`. To proceed with `docker-io` installation on |
|
| 16 |
-Fedora 20, please remove `docker` first. |
|
| 17 |
- |
|
| 18 |
- $ sudo yum -y remove docker |
|
| 19 |
- $ sudo yum -y install docker-io |
|
| 20 |
- |
|
| 21 |
-For `Fedora 21 and later`, there are no package conflicts as the system |
|
| 22 |
-tray application and its executable have been renamed `wmdocker`. |
|
| 16 |
+## Fedora 21 and later installation |
|
| 23 | 17 |
|
| 24 | 18 |
Install the `docker` package which will install Docker on our host. |
| 25 | 19 |
|
| ... | ... |
@@ -29,6 +23,27 @@ To update the `docker` package: |
| 29 | 29 |
|
| 30 | 30 |
$ sudo yum -y update docker |
| 31 | 31 |
|
| 32 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 33 |
+ |
|
| 34 |
+## Fedora 20 installation |
|
| 35 |
+ |
|
| 36 |
+For `Fedora 20`, there is a package name conflict with a system tray application |
|
| 37 |
+and its executable, so the Docker RPM package was called `docker-io`. |
|
| 38 |
+ |
|
| 39 |
+To proceed with `docker-io` installation on Fedora 20, please remove the `docker` |
|
| 40 |
+package first. |
|
| 41 |
+ |
|
| 42 |
+ $ sudo yum -y remove docker |
|
| 43 |
+ $ sudo yum -y install docker-io |
|
| 44 |
+ |
|
| 45 |
+To update the `docker` package: |
|
| 46 |
+ |
|
| 47 |
+ $ sudo yum -y update docker-io |
|
| 48 |
+ |
|
| 49 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 50 |
+ |
|
| 51 |
+## Starting the Docker daemon |
|
| 52 |
+ |
|
| 32 | 53 |
Now that it's installed, let's start the Docker daemon. |
| 33 | 54 |
|
| 34 | 55 |
$ sudo systemctl start docker |
| ... | ... |
@@ -60,8 +75,8 @@ create a `docker` group, have it own `/var/run/docker.sock`, and add users to th |
| 60 | 60 |
## Custom daemon options |
| 61 | 61 |
|
| 62 | 62 |
If you need to add an HTTP Proxy, set a different directory or partition for the |
| 63 |
-Docker runtime files, or make other customizations, read our systemd article to |
|
| 64 |
-learn how to [customize your systemd Docker daemon options](/articles/systemd/). |
|
| 63 |
+Docker runtime files, or make other customizations, read our Systemd article to |
|
| 64 |
+learn how to [customize your Systemd Docker daemon options](/articles/systemd/). |
|
| 65 | 65 |
|
| 66 | 66 |
## What next? |
| 67 | 67 |
|
| ... | ... |
@@ -1,10 +1,24 @@ |
| 1 | 1 |
page_title: Installation on Red Hat Enterprise Linux |
| 2 |
-page_description: Installation instructions for Docker on Red Hat Enterprise Linux. |
|
| 3 |
-page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos |
|
| 2 |
+page_description: Instructions for installing Docker on Red Hat Enterprise Linux. |
|
| 3 |
+page_keywords: Docker, Docker documentation, requirements, linux, rhel |
|
| 4 | 4 |
|
| 5 |
-# Red Hat Enterprise Linux 7 |
|
| 5 |
+# Red Hat Enterprise Linux |
|
| 6 | 6 |
|
| 7 |
-**Red Hat Enterprise Linux 7** has [shipped with |
|
| 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 |
|
| 8 | 22 |
Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers). |
| 9 | 23 |
An overview and some guidance can be found in the [Release |
| 10 | 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,51 +39,44 @@ Enterprise Linux 7](https://access.redhat.com/site/articles/881893) |
| 25 | 25 |
guide, can be found by Red Hat customers on the [Red Hat Customer |
| 26 | 26 |
Portal](https://access.redhat.com/). |
| 27 | 27 |
|
| 28 |
-# Red Hat Enterprise Linux 6 |
|
| 29 |
- |
|
| 30 |
-Docker is available for **RHEL** on EPEL. Please note that |
|
| 31 |
-this package is part of [Extra Packages for Enterprise Linux |
|
| 32 |
-(EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to |
|
| 33 |
-create and maintain additional packages for the RHEL distribution. |
|
| 28 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 34 | 29 |
|
| 35 |
-Also note that due to the current Docker limitations, Docker is able to |
|
| 36 |
-run only on the **64 bit** architecture. |
|
| 30 |
+## Red Hat Enterprise Linux 6.5 Installation |
|
| 37 | 31 |
|
| 38 |
-You will need [RHEL |
|
| 39 |
-6.5](https://access.redhat.com/site/articles/3078#RHEL6) or higher, with |
|
| 32 |
+You will need **64 bit** [RHEL |
|
| 33 |
+6.5](https://access.redhat.com/site/articles/3078#RHEL6) or later, with |
|
| 40 | 34 |
a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel |
| 41 | 35 |
fixes to allow Docker to work. |
| 42 | 36 |
|
| 43 |
-## Kernel support |
|
| 44 |
- |
|
| 45 |
-RHEL will only support Docker via the *extras* channel or EPEL package when |
|
| 46 |
-running on kernels shipped by the distribution. There are things like namespace |
|
| 47 |
-changes which will cause issues if one decides to step outside that box and run |
|
| 48 |
-non-distro kernel packages. |
|
| 49 |
- |
|
| 50 |
-## Installation |
|
| 37 |
+Docker is available for **RHEL6.5** on EPEL. Please note that |
|
| 38 |
+this package is part of [Extra Packages for Enterprise Linux |
|
| 39 |
+(EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to |
|
| 40 |
+create and maintain additional packages for the RHEL distribution. |
|
| 51 | 41 |
|
| 52 | 42 |
Firstly, you need to install the EPEL repository. Please follow the |
| 53 | 43 |
[EPEL installation |
| 54 | 44 |
instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). |
| 55 | 45 |
|
| 56 |
-The `docker-io` package provides Docker on EPEL. |
|
| 46 |
+There is a package name conflict with a system tray application |
|
| 47 |
+and its executable, so the Docker RPM package was called `docker-io`. |
|
| 48 |
+ |
|
| 49 |
+To proceed with `docker-io` installation, you may need to remove the |
|
| 50 |
+`docker` package first. |
|
| 57 | 51 |
|
| 58 |
-If you already have the (unrelated) `docker` package |
|
| 59 |
-installed, it will conflict with `docker-io`. |
|
| 60 |
-There's a [bug report]( |
|
| 61 |
-https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it. |
|
| 62 |
-To proceed with `docker-io` installation, please remove `docker` first. |
|
| 52 |
+ $ sudo yum -y remove docker |
|
| 63 | 53 |
|
| 64 |
-Next, let's install the `docker-io` package which |
|
| 65 |
-will install Docker on our host. |
|
| 54 |
+Next, let's install the `docker-io` package which will install Docker on our host. |
|
| 66 | 55 |
|
| 67 |
- $ sudo yum -y install docker-io |
|
| 56 |
+ $ sudo yum install docker-io |
|
| 68 | 57 |
|
| 69 | 58 |
To update the `docker-io` package |
| 70 | 59 |
|
| 71 | 60 |
$ sudo yum -y update docker-io |
| 72 | 61 |
|
| 62 |
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon). |
|
| 63 |
+ |
|
| 64 |
+## Starting the Docker daemon |
|
| 65 |
+ |
|
| 73 | 66 |
Now that it's installed, let's start the Docker daemon. |
| 74 | 67 |
|
| 75 | 68 |
$ sudo service docker start |
| ... | ... |
@@ -93,8 +100,8 @@ Continue with the [User Guide](/userguide/). |
| 93 | 93 |
## Custom daemon options |
| 94 | 94 |
|
| 95 | 95 |
If you need to add an HTTP Proxy, set a different directory or partition for the |
| 96 |
-Docker runtime files, or make other customizations, read our systemd article to |
|
| 97 |
-learn how to [customize your systemd Docker daemon options](/articles/systemd/). |
|
| 96 |
+Docker runtime files, or make other customizations, read our Systemd article to |
|
| 97 |
+learn how to [customize your Systemd Docker daemon options](/articles/systemd/). |
|
| 98 | 98 |
|
| 99 | 99 |
|
| 100 | 100 |
## Issues? |