2014-04-15 20:53:12 -04:00
|
|
|
page_title: Installation on Fedora
|
2014-05-27 13:08:19 -04:00
|
|
|
page_description: Installation instructions for Docker on Fedora.
|
2014-04-15 20:53:12 -04:00
|
|
|
page_keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux
|
|
|
|
|
|
|
|
# Fedora
|
|
|
|
|
|
|
|
Docker is available in **Fedora 19 and later**. Please note that due to
|
|
|
|
the current Docker limitations Docker is able to run only on the **64
|
|
|
|
bit** architecture.
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
The `docker-io` package provides Docker on Fedora.
|
|
|
|
|
2014-04-17 18:55:24 -04:00
|
|
|
If you have the (unrelated) `docker` package installed already, it will
|
2014-04-23 16:48:28 -04:00
|
|
|
conflict with `docker-io`. There's a [bug
|
2014-04-15 20:53:12 -04:00
|
|
|
report](https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for
|
2014-04-17 18:55:24 -04:00
|
|
|
it. To proceed with `docker-io` installation on Fedora 19, please remove
|
|
|
|
`docker` first.
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo yum -y remove docker
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-05-26 07:29:27 -04:00
|
|
|
For Fedora 21 and later, the `wmdocker` package will
|
2014-04-15 20:53:12 -04:00
|
|
|
provide the same functionality as `docker` and will
|
|
|
|
also not conflict with `docker-io`.
|
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo yum -y install wmdocker
|
|
|
|
$ sudo yum -y remove docker
|
2014-04-15 20:53:12 -04:00
|
|
|
|
|
|
|
Install the `docker-io` package which will install
|
|
|
|
Docker on our host.
|
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo yum -y install docker-io
|
2014-04-15 20:53:12 -04:00
|
|
|
|
|
|
|
To update the `docker-io` package:
|
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo yum -y update docker-io
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-04-23 16:48:28 -04:00
|
|
|
Now that it's installed, let's start the Docker daemon.
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo systemctl start docker
|
2014-04-15 20:53:12 -04:00
|
|
|
|
|
|
|
If we want Docker to start at boot, we should also:
|
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo systemctl enable docker
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-04-23 16:48:28 -04:00
|
|
|
Now let's verify that Docker is working.
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-05-01 10:13:34 -04:00
|
|
|
$ sudo docker run -i -t fedora /bin/bash
|
2014-04-15 20:53:12 -04:00
|
|
|
|
2014-06-17 07:52:52 -04:00
|
|
|
## 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
|
|
|
|
socket file `/var/run/docker.sock` owned by group `docker`. One must be
|
|
|
|
member of that group in order to contact the `docker -d` process.
|
|
|
|
|
|
|
|
$ usermod -a -G docker login_name
|
|
|
|
|
|
|
|
Adding users to the `docker` group is *not* necessary for Docker versions 1.0
|
|
|
|
and above.
|
|
|
|
|
|
|
|
## HTTP Proxy
|
|
|
|
|
|
|
|
If you are behind a HTTP proxy server, for example in corporate settings,
|
|
|
|
you will need to add this configuration in the Docker *systemd service file*.
|
|
|
|
|
|
|
|
Edit file `/lib/systemd/system/docker.service`. Add the following to
|
|
|
|
section `[Service]` :
|
|
|
|
|
|
|
|
Environment="HTTP_PROXY=http://proxy.example.com:80/"
|
|
|
|
|
|
|
|
If you have internal Docker registries that you need to contact without
|
|
|
|
proxying you can specify them via the `NO_PROXY` environment variable:
|
|
|
|
|
|
|
|
Environment="HTTP_PROXY=http://proxy.example.com:80/" "NO_PROXY=localhost,127.0.0.0/8,docker-registry.somecorporation.com"
|
|
|
|
|
|
|
|
Flush changes:
|
|
|
|
|
|
|
|
$ systemctl daemon-reload
|
|
|
|
|
|
|
|
Restart Docker:
|
|
|
|
|
|
|
|
$ systemctl start docker
|
|
|
|
|
2014-05-21 17:05:19 -04:00
|
|
|
## What next?
|
|
|
|
|
|
|
|
Continue with the [User Guide](/userguide/).
|
|
|
|
|