github.com/jogo/docker@v1.7.0-rc1/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/).
    98  
    99  ## Uninstallation
   100  
   101  To uninstall the Docker package:
   102  
   103      $ sudo emerge -cav app-emulation/docker
   104  
   105  To uninstall the Docker package and dependencies that are no longer needed:
   106  
   107      $ sudo emerge -C app-emulation/docker
   108  
   109  The above commands will not remove images, containers, volumes, or user created
   110  configuration files on your host. If you wish to delete all images, containers,
   111  and volumes run the following command:
   112  
   113      $ rm -rf /var/lib/docker
   114  
   115  You must delete the user created configuration files manually.