summaryrefslogtreecommitdiff
path: root/docs/sources/installation/fedora.rst
blob: 3b95f04f7fe22ab44714f493de2a21e3d8fbf332 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
:title: Installation on Fedora
:description: Please note this project is currently under heavy development. It should not be used in production.
:keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux

.. _fedora:

Fedora
======

.. include:: install_header.inc

.. include:: install_unofficial.inc

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`_ filed for it.
To proceed with ``docker-io`` installation on Fedora 19 or Fedora 20, please
remove ``docker`` first.

.. code-block:: bash

   sudo yum -y remove docker

For Fedora 21 and later, the ``wmdocker`` package will provide the same
functionality as the old ``docker`` and will also not conflict with ``docker-io``.

.. code-block:: bash

   sudo yum -y install wmdocker
   sudo yum -y remove docker

Install the ``docker-io`` package which will install Docker on our host.

.. code-block:: bash

   sudo yum -y install docker-io


To update the ``docker-io`` package:

.. code-block:: bash

   sudo yum -y update docker-io

Now that it's installed, let's start the Docker daemon.

.. code-block:: bash

    sudo systemctl start docker

If we want Docker to start at boot, we should also:

.. code-block:: bash

   sudo systemctl enable docker

Now let's verify that Docker is working.

.. code-block:: bash

   sudo docker run -i -t fedora /bin/bash

**Done!**, now continue with the :ref:`hello_world` example.

.. _bug report: https://bugzilla.redhat.com/show_bug.cgi?id=1043676