mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
78 lines
2.9 KiB
Markdown
78 lines
2.9 KiB
Markdown
page_title: Installation on Gentoo
|
||
page_description: Please note this project is currently under heavy development. It should not be used in production.
|
||
page_keywords: gentoo linux, virtualization, docker, documentation, installation
|
||
|
||
# Gentoo
|
||
|
||
> **Note**:
|
||
> Docker is still under heavy development! We don’t recommend using it in
|
||
> production yet, but we’re getting closer with each release. Please see
|
||
> our blog post, [Getting to Docker 1.0](
|
||
> http://blog.docker.io/2013/08/getting-to-docker-1-0/)
|
||
|
||
> **Note**:
|
||
> This is a community contributed installation path. The only ‘official’
|
||
> installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux)
|
||
> installation path. This version may be out of date because it depends on
|
||
> some binaries to be updated and published
|
||
|
||
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](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.
|
||
|
||
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:
|
||
|
||
sudo /etc/init.d/docker start
|
||
|
||
To start on system boot:
|
||
|
||
sudo rc-update add docker default
|
||
|
||
### systemd
|
||
|
||
To start the docker daemon:
|
||
|
||
sudo systemctl start docker.service
|
||
|
||
To start on system boot:
|
||
|
||
sudo systemctl enable docker.service
|