mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
10d57b648f
Docker-DCO-1.1-Signed-off-by: O.S. Tezer <ostezer@gmail.com> (github: ostezer) 1. All titles are listed by simple platform names apart from Windows' "Installing Docker On Windows". Changed this to "Windows" to match the rest. 2. Some articles' description (and title) information does not match the majority. Modified them to match the rest (i.e. Please note this project is currently under heavy development. It should not be used in production.) 3. Removed "Linux" from Gentoo & Ubuntu descriptions.
84 lines
2.6 KiB
ReStructuredText
84 lines
2.6 KiB
ReStructuredText
:title: Installation on Gentoo
|
|
:description: Please note this project is currently under heavy development. It should not be used in production.
|
|
:keywords: gentoo linux, virtualization, docker, documentation, installation
|
|
|
|
.. _gentoo_linux:
|
|
|
|
Gentoo
|
|
======
|
|
|
|
.. include:: install_header.inc
|
|
|
|
.. include:: install_unofficial.inc
|
|
|
|
Installing Docker on Gentoo Linux can be accomplished using one of two methods.
|
|
The first and best way if you're looking for a stable experience is to use the
|
|
official `app-emulation/docker` package directly in the portage tree.
|
|
|
|
If you're looking for a ``-bin`` ebuild, a live ebuild, or bleeding edge
|
|
ebuild changes/fixes, the second installation method is to use the overlay
|
|
provided at https://github.com/tianon/docker-overlay which can be added using
|
|
``app-portage/layman``. The most accurate and up-to-date documentation for
|
|
properly installing and using the overlay can be found in `the overlay README
|
|
<https://github.com/tianon/docker-overlay/blob/master/README.md#using-this-overlay>`_.
|
|
|
|
Note that sometimes there is a disparity between the latest version and what's
|
|
in the overlay, and between the latest version in the overlay and what's in the
|
|
portage tree. Please be patient, and the latest version should propagate
|
|
shortly.
|
|
|
|
Installation
|
|
^^^^^^^^^^^^
|
|
|
|
The package should properly pull in all the necessary dependencies and prompt
|
|
for all necessary kernel options. The ebuilds for 0.7+ include use flags to
|
|
pull in the proper dependencies of the major storage drivers, with the
|
|
"device-mapper" use flag being enabled by default, since that is the simplest
|
|
installation path.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo emerge -av app-emulation/docker
|
|
|
|
If any issues arise from this ebuild or the resulting binary, including and
|
|
especially missing kernel configuration flags and/or dependencies, `open an
|
|
issue on the docker-overlay repository
|
|
<https://github.com/tianon/docker-overlay/issues>`_ or ping tianon directly in
|
|
the #docker IRC channel on the freenode network.
|
|
|
|
Starting Docker
|
|
^^^^^^^^^^^^^^^
|
|
|
|
Ensure that you are running a kernel that includes all the necessary modules
|
|
and/or configuration for LXC (and optionally for device-mapper and/or AUFS,
|
|
depending on the storage driver you've decided to use).
|
|
|
|
OpenRC
|
|
------
|
|
|
|
To start the docker daemon:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo /etc/init.d/docker start
|
|
|
|
To start on system boot:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo rc-update add docker default
|
|
|
|
systemd
|
|
-------
|
|
|
|
To start the docker daemon:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo systemctl start docker.service
|
|
|
|
To start on system boot:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo systemctl enable docker.service
|