github.com/guilhermebr/docker@v1.4.2-0.20150428121140-67da055cebca/docs/sources/installation/gentoolinux.md (about)

     1  page_title: Installation on Gentoo
     2  page_description: Installation instructions for Docker on Gentoo.
     3  page_keywords: gentoo linux, virtualization, docker, documentation, installation
     4  
     5  # Gentoo
     6  
     7  Installing Docker on Gentoo Linux can be accomplished using one of two ways: the **official** way and the `docker-overlay` way.
     8  
     9  Official project page of [Gentoo Docker](https://wiki.gentoo.org/wiki/Project:Docker) team.
    10  
    11  ## Official way
    12  The first and recommended way if you are looking for a stable  
    13  experience is to use the official `app-emulation/docker` package directly  
    14  from the tree.
    15  
    16  If any issues arise from this ebuild including, missing kernel 
    17  configuration flags or dependencies, open a bug 
    18  on the Gentoo [Bugzilla](https://bugs.gentoo.org) assigned to `docker AT gentoo DOT org` 
    19  or join and ask in the official
    20  [IRC](http://webchat.freenode.net?channels=%23gentoo-containers&uio=d4) channel on the Freenode network.
    21  
    22  ## docker-overlay way
    23  
    24  If you're looking for a `-bin` ebuild, a live ebuild, or a bleeding edge
    25  ebuild, use the provided overlay, [docker-overlay](https://github.com/tianon/docker-overlay)
    26  which can be added using `app-portage/layman`. The most accurate and
    27  up-to-date documentation for properly installing and using the overlay
    28  can be found in the [overlay](https://github.com/tianon/docker-overlay/blob/master/README.md#using-this-overlay).
    29  
    30  If any issues arise from this ebuild or the resulting binary, including
    31  and especially missing kernel configuration flags or dependencies, 
    32  open an [issue](https://github.com/tianon/docker-overlay/issues) on 
    33  the `docker-overlay` repository or ping `tianon` directly in the `#docker` 
    34  IRC channel on the Freenode network.
    35  
    36  ## Installation
    37  
    38  ### Available USE flags
    39  
    40  | USE Flag      | Default | Description |
    41  | ------------- |:-------:|:------------|
    42  | aufs          |         |Enables dependencies for the "aufs" graph driver, including necessary kernel flags.|
    43  | btrfs         |         |Enables dependencies for the "btrfs" graph driver, including necessary kernel flags.|
    44  | contrib       |  Yes    |Install additional contributed scripts and components.|
    45  | device-mapper |  Yes    |Enables dependencies for the "devicemapper" graph driver, including necessary kernel flags.|
    46  | doc           |         |Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally.|
    47  | lxc           |         |Enables dependencies for the "lxc" execution driver.|
    48  | vim-syntax    |         |Pulls in related vim syntax scripts.|
    49  | zsh-completion|         |Enable zsh completion support.|
    50  
    51  USE flags are described in detail on [tianon's
    52  blog](https://tianon.github.io/post/2014/05/17/docker-on-gentoo.html).
    53  
    54  The package should properly pull in all the necessary dependencies and
    55  prompt for all necessary kernel options.
    56  
    57      $ sudo emerge -av app-emulation/docker
    58  
    59  >Note: Sometimes there is a disparity between the latest versions 
    60  >in the official **Gentoo tree** and the **docker-overlay**.  
    61  >Please be patient, and the latest version should propagate shortly.
    62  
    63  ## Starting Docker
    64  
    65  Ensure that you are running a kernel that includes all the necessary
    66  modules and configuration (and optionally for device-mapper
    67  and AUFS or Btrfs, depending on the storage driver you've decided to use).
    68  
    69  To use Docker, the `docker` daemon must be running as **root**.  
    70  To use Docker as a **non-root** user, add yourself to the **docker** 
    71  group by running the following command:
    72  
    73      $ sudo usermod -a -G docker user
    74   
    75  ### OpenRC
    76  
    77  To start the `docker` daemon:
    78  
    79      $ sudo /etc/init.d/docker start
    80  
    81  To start on system boot:
    82  
    83      $ sudo rc-update add docker default
    84  
    85  ### systemd
    86  
    87  To start the `docker` daemon:
    88  
    89      $ sudo systemctl start docker
    90  
    91  To start on system boot:
    92  
    93      $ sudo systemctl enable docker
    94     
    95  If you need to add an HTTP Proxy, set a different directory or partition for the
    96  Docker runtime files, or make other customizations, read our systemd article to
    97  learn how to [customize your systemd Docker daemon options](/articles/systemd/).