mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
9559f57463
Docker-DCO-1.1-Signed-off-by: Alexander Shopov <ash@kambanaria.org> (github: alshopov) Squashed by Docker-DCO-1.1-Signed-off-by: SvenDowideit <SvenDowideit@home.org.au> (github: SvenDowideit) replaces #6478 Docker-DCO-1.1-Signed-off-by: Alexander Shopov <ash@kambanaria.org> (github: )
92 lines
2.7 KiB
Markdown
92 lines
2.7 KiB
Markdown
page_title: Installation on Fedora
|
|
page_description: Installation instructions for Docker on Fedora.
|
|
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.
|
|
|
|
If you have the (unrelated) `docker` package installed already, it will
|
|
conflict with `docker-io`. There's a [bug
|
|
report](https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for
|
|
it. To proceed with `docker-io` installation on Fedora 19, please remove
|
|
`docker` first.
|
|
|
|
$ 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
|
|
|
|
To update the `docker-io` package:
|
|
|
|
$ sudo yum -y update docker-io
|
|
|
|
Now that it's installed, let's start the Docker daemon.
|
|
|
|
$ sudo systemctl start docker
|
|
|
|
If we want Docker to start at boot, we should also:
|
|
|
|
$ sudo systemctl enable docker
|
|
|
|
Now let's verify that Docker is working.
|
|
|
|
$ sudo docker run -i -t fedora /bin/bash
|
|
|
|
## 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
|
|
|
|
## What next?
|
|
|
|
Continue with the [User Guide](/userguide/).
|
|
|