docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10578 from SvenDowideit/copy-edit-10516-fedora-install 

Copy edit 10516 fedora install
This commit is contained in:
Michael Crosby 2015-02-06 15:14:31 -08:00
parent e706be77a4 eb814e4e70
commit dfa1a84937
3 changed files with 132 additions and 117 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

99
docs/sources/installation/centos.md
View File

@ -4,48 +4,34 @@ page_keywords: Docker, Docker documentation, requirements, linux, centos, epel,
# CentOS # CentOS
While the Docker package is provided by default as part of CentOS-7, Docker is supported on the following versions of CentOS:
it is provided by the EPEL repository for CentOS-6. Please note that
this changes the installation instructions slightly between versions. If you
need the latest version, you can always use the latest binary which works on
kernel 3.8 and above.
These instructions work for CentOS 6 and later. They will likely work for - [*CentOS 7 (64-bit)*](#installing-docker---centos-7)
other binary compatible EL6 distributions such as Scientific Linux, but - [*CentOS 6.5 (64-bit)*](#installing-docker---centos-6.5) or later
they haven't been tested.
These instructions are likely work for other binary compatible EL6/EL7 distributions
such as Scientific Linux, but they haven't been tested.
Please note that due to the current Docker limitations, Docker is able to Please note that due to the current Docker limitations, Docker is able to
run only on the **64 bit** architecture. run only on the **64 bit** architecture.
To run Docker, you will need [CentOS6](http://www.centos.org) or higher, ## Kernel support
with a kernel version 2.6.32-431 or higher as this has specific kernel
fixes to allow Docker to run. Currently the CentOS project will only support Docker when running on kernels
shipped by the distribution. There are kernel changes which will cause issues
if one decides to step outside that box and run non-distribution kernel packages.
To run Docker on [CentOS-6.5](http://www.centos.org) or later, you will need
kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow
Docker to run.
## Installing Docker - CentOS-7 ## Installing Docker - CentOS-7
Docker is included by default in the CentOS-Extras repository. To install Docker is included by default in the CentOS-Extras repository. To install
simply run the following command. run the following command:
$ sudo yum install docker $ sudo yum install docker
## Kernel support Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
Currently the CentOS project will only support Docker via the EPEL package when
running on kernels shipped by the distribution. There are things like namespace
changes which will cause issues if one decides to step outside that box and run
non-distro kernel packages.
### Manual installation of latest version
While using a package is the recommended way of installing Docker,
the above package might not be the latest version. If you need the latest
version, [you can install the binary directly](
https://docs.docker.com/installation/binaries/).
When installing the binary without a package, you may want
to integrate Docker with systemd. For this, simply install the two unit files
(service and socket) from [the github
repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
to `/etc/systemd/system`.
### FirewallD ### FirewallD
@ -55,32 +41,49 @@ conflict with Docker.
When `firewalld` is started or restarted it will remove the `DOCKER` chain When `firewalld` is started or restarted it will remove the `DOCKER` chain
from iptables, preventing Docker from working properly. from iptables, preventing Docker from working properly.
When using systemd, `firewalld` is started before Docker, but if you When using Systemd, `firewalld` is started before Docker, but if you
start or restart `firewalld` after Docker, you will have to restart the Docker daemon. start or restart `firewalld` after Docker, you will have to restart the Docker daemon.
## Installing Docker - CentOS-6 ## Installing Docker - CentOS-6.5
Please note that this for CentOS-6, this package is part of [Extra Packages
for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort For Centos-6.5, the Docker package is part of [Extra Packages
to create and maintain additional packages for the RHEL distribution. for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository,
a community effort to create and maintain additional packages for the RHEL distribution.
Firstly, you need to ensure you have the EPEL repository enabled. Please Firstly, you need to ensure you have the EPEL repository enabled. Please
follow the [EPEL installation instructions]( follow the [EPEL installation instructions](
https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
The `docker-io` package provides Docker on EPEL. For CentOS-6, there is a package name conflict with a system tray application
and its executable, so the Docker RPM package was called `docker-io`.
If you already have the (unrelated) `docker` package To proceed with `docker-io` installation on CentOS-6, you may need to remove the
installed, it will conflict with `docker-io`. `docker` package first.
There's a [bug report](
https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
To proceed with `docker-io` installation, please remove `docker` first.
Next, let's install the `docker-io` package which $ sudo yum -y remove docker
will install Docker on our host.
Next, let's install the `docker-io` package which will install Docker on our host.
$ sudo yum install docker-io $ sudo yum install docker-io
## Using Docker Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Manual installation of latest Docker release
While using a package is the recommended way of installing Docker,
the above package might not be the current release version. If you need the latest
version, [you can install the binary directly](
https://docs.docker.com/installation/binaries/).
When installing the binary without a package, you may want
to integrate Docker with Systemd. For this, install the two unit files
(service and socket) from [the GitHub
repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
to `/etc/systemd/system`.
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Starting the Docker daemon
Once Docker is installed, you will need to start the docker daemon. Once Docker is installed, you will need to start the docker daemon.
@ -115,13 +118,13 @@ If everything is working properly, you'll get a simple bash prompt. Type
## Custom daemon options ## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the 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 Docker runtime files, or make other customizations, read our Systemd article to
learn how to [customize your systemd Docker daemon options](/articles/systemd/). learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
## Dockerfiles ## Dockerfiles
The CentOS Project provides a number of sample Dockerfiles which you may use The CentOS Project provides a number of sample Dockerfiles which you may use
either as templates or to familiarize yourself with docker. These templates either as templates or to familiarize yourself with docker. These templates
are available on github at [https://github.com/CentOS/CentOS-Dockerfiles]( are available on GitHub at [https://github.com/CentOS/CentOS-Dockerfiles](
https://github.com/CentOS/CentOS-Dockerfiles) https://github.com/CentOS/CentOS-Dockerfiles)
**Done!** You can either continue with the [Docker User **Done!** You can either continue with the [Docker User

77
docs/sources/installation/fedora.md
View File

@ -1,41 +1,49 @@
page_title: Installation on Fedora page_title: Installation on Fedora
page_description: Installation instructions for Docker on Fedora. page_description: Instructions for installing Docker on Fedora.
page_keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux page_keywords: Docker, Docker documentation, Fedora, requirements, linux
# Fedora # Fedora
Docker is available in **Fedora 19 and later**. Please note that due to Docker is supported on the following versions of Fedora:
the current Docker limitations Docker is able to run only on the **64
bit** architecture.
## Installation - [*Fedora 20 (64-bit)*](#fedora-20-installation)
- [*Fedora 21 and later (64-bit)*](#fedora-21-and-later-installation)
The `docker-io` package provides Docker on Fedora. Currently the Fedora project will only support Docker when running on kernels
shipped by the distribution. There are kernel changes which will cause issues
if one decides to step outside that box and run non-distribution kernel packages.
If you have the (unrelated) `docker` package installed already, it will ## Fedora 21 and later installation
conflict with `docker-io`. There's a [bug
report](https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for Install the `docker` package which will install Docker on our host.
it. To proceed with `docker-io` installation on Fedora 19, please remove
`docker` first. $ sudo yum -y install docker
To update the `docker` package:
$ sudo yum -y update docker
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Fedora 20 installation
For `Fedora 20`, there is a package name conflict with a system tray application
and its executable, so the Docker RPM package was called `docker-io`.
To proceed with `docker-io` installation on Fedora 20, please remove the `docker`
package first.
$ sudo yum -y remove docker $ sudo yum -y remove docker
For Fedora 21 and later, the `wmdocker` package will
provide the same functionality as `docker` and will
also not conflict with `docker-io`.
$ sudo yum -y install wmdocker
$ sudo yum -y remove docker
Install the `docker-io` package which will install
Docker on our host.
$ sudo yum -y install docker-io $ sudo yum -y install docker-io
To update the `docker-io` package: To update the `docker` package:
$ sudo yum -y update docker-io $ sudo yum -y update docker-io
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Starting the Docker daemon
Now that it's installed, let's start the Docker daemon. Now that it's installed, let's start the Docker daemon.
$ sudo systemctl start docker $ sudo systemctl start docker
@ -54,24 +62,21 @@ Now let's verify that Docker is working.
## Granting rights to users to use Docker ## Granting rights to users to use Docker
Fedora 19 and 20 shipped with Docker 0.11. The package has already been updated
to 1.0 in Fedora 20. If you are still using the 0.11 version you will need to
grant rights to users of Docker.
The `docker` command line tool contacts the `docker` daemon process via a The `docker` command line tool contacts the `docker` daemon process via a
socket file `/var/run/docker.sock` owned by group `docker`. One must be socket file `/var/run/docker.sock` owned by `root:root`. Though it's
member of that group in order to contact the `docker -d` process. [recommended](https://lists.projectatomic.io/projectatomic-archives/atomic-devel/2015-January/msg00034.html)
to use `sudo` for docker commands, if users wish to avoid it, an administrator can
create a `docker` group, have it own `/var/run/docker.sock`, and add users to this group.
$ usermod -a -G docker login_name $ sudo groupadd docker
$ sudo chown root:docker /var/run/docker.sock
Adding users to the `docker` group is *not* necessary for Docker versions 1.0 $ sudo usermod -a -G docker $USERNAME
and above.
## Custom daemon options ## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the 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 Docker runtime files, or make other customizations, read our Systemd article to
learn how to [customize your systemd Docker daemon options](/articles/systemd/). learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
## What next? ## What next?

73
docs/sources/installation/rhel.md
View File

@ -1,10 +1,24 @@
page_title: Installation on Red Hat Enterprise Linux page_title: Installation on Red Hat Enterprise Linux
page_description: Installation instructions for Docker on Red Hat Enterprise Linux. page_description: Instructions for installing Docker on Red Hat Enterprise Linux.
page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos page_keywords: Docker, Docker documentation, requirements, linux, rhel
# Red Hat Enterprise Linux 7 # Red Hat Enterprise Linux
**Red Hat Enterprise Linux 7** has [shipped with Docker is supported on the following versions of RHEL:
- [*Red Hat Enterprise Linux 7 (64-bit)*](#red-hat-enterprise-linux-7-installation)
- [*Red Hat Enterprise Linux 6.5 (64-bit)*](#red-hat-enterprise-linux-6.5-installation) or later
## Kernel support
RHEL will only support Docker via the *extras* channel or EPEL package when
running on kernels shipped by the distribution. There are kernel changes which
will cause issues if one decides to step outside that box and run
non-distribution kernel packages.
## Red Hat Enterprise Linux 7 Installation
**Red Hat Enterprise Linux 7 (64 bit)** has [shipped with
Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers). Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers).
An overview and some guidance can be found in the [Release An overview and some guidance can be found in the [Release
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). 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)
guide, can be found by Red Hat customers on the [Red Hat Customer guide, can be found by Red Hat customers on the [Red Hat Customer
Portal](https://access.redhat.com/). Portal](https://access.redhat.com/).
# Red Hat Enterprise Linux 6 Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
Docker is available for **RHEL** on EPEL. Please note that ## Red Hat Enterprise Linux 6.5 Installation
this package is part of [Extra Packages for Enterprise Linux
(EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
create and maintain additional packages for the RHEL distribution.
Also note that due to the current Docker limitations, Docker is able to You will need **64 bit** [RHEL
run only on the **64 bit** architecture. 6.5](https://access.redhat.com/site/articles/3078#RHEL6) or later, with
You will need [RHEL
6.5](https://access.redhat.com/site/articles/3078#RHEL6) or higher, with
a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel
fixes to allow Docker to work. fixes to allow Docker to work.
## Kernel support Docker is available for **RHEL6.5** on EPEL. Please note that
this package is part of [Extra Packages for Enterprise Linux
RHEL will only support Docker via the *extras* channel or EPEL package when (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
running on kernels shipped by the distribution. There are things like namespace create and maintain additional packages for the RHEL distribution.
changes which will cause issues if one decides to step outside that box and run
non-distro kernel packages.
## Installation
Firstly, you need to install the EPEL repository. Please follow the Firstly, you need to install the EPEL repository. Please follow the
[EPEL installation [EPEL installation
instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
The `docker-io` package provides Docker on EPEL. There is a package name conflict with a system tray application
and its executable, so the Docker RPM package was called `docker-io`.
If you already have the (unrelated) `docker` package To proceed with `docker-io` installation, you may need to remove the
installed, it will conflict with `docker-io`. `docker` package first.
There's a [bug report](
https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
To proceed with `docker-io` installation, please remove `docker` first.
Next, let's install the `docker-io` package which $ sudo yum -y remove docker
will install Docker on our host.
$ sudo yum -y install docker-io Next, let's install the `docker-io` package which will install Docker on our host.
$ sudo yum install docker-io
To update the `docker-io` package To update the `docker-io` package
$ sudo yum -y update docker-io $ sudo yum -y update docker-io
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
## Starting the Docker daemon
Now that it's installed, let's start the Docker daemon. Now that it's installed, let's start the Docker daemon.
$ sudo service docker start $ sudo service docker start
@ -93,8 +100,8 @@ Continue with the [User Guide](/userguide/).
## Custom daemon options ## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the 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 Docker runtime files, or make other customizations, read our Systemd article to
learn how to [customize your systemd Docker daemon options](/articles/systemd/). learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
## Issues? ## Issues?