github.com/eikeon/docker@v1.5.0-rc4/docs/sources/installation/debian.md (about)

     1  page_title: Installation on Debian
     2  page_description: Instructions for installing Docker on Debian.
     3  page_keywords: Docker, Docker documentation, installation, debian
     4  
     5  # Debian
     6  
     7  Docker is supported on the following versions of Debian:
     8  
     9   - [*Debian 8.0 Jessie (64-bit)*](#debian-jessie-80-64-bit)
    10   - [*Debian 7.7 Wheezy (64-bit)*](#debian-wheezystable-7x-64-bit)
    11  
    12  ## Debian Jessie 8.0 (64-bit)
    13  
    14  Debian 8 comes with a 3.14.0 Linux kernel, and a `docker.io` package which
    15  installs all its prerequisites from Debian's repository.
    16  
    17  > **Note**:
    18  > Debian contains a much older KDE3/GNOME2 package called ``docker``, so the
    19  > package and the executable are called ``docker.io``.
    20  
    21  ### Installation
    22  
    23  To install the latest Debian package (may not be the latest Docker release):
    24  
    25      $ sudo apt-get update
    26      $ sudo apt-get install docker.io
    27  
    28  To verify that everything has worked as expected:
    29  
    30      $ sudo docker run -i -t ubuntu /bin/bash
    31  
    32  Which should download the `ubuntu` image, and then start `bash` in a container.
    33  
    34  > **Note**: 
    35  > If you want to enable memory and swap accounting see
    36  > [this](/installation/ubuntulinux/#memory-and-swap-accounting).
    37  
    38  ## Debian Wheezy/Stable 7.x (64-bit)
    39  
    40  Docker requires Kernel 3.8+, while Wheezy ships with Kernel 3.2 (for more details
    41  on why 3.8 is required, see discussion on
    42  [bug #407](https://github.com/docker/docker/issues/407%20kernel%20versions)).
    43  
    44  Fortunately, wheezy-backports currently has [Kernel 3.16
    45  ](https://packages.debian.org/search?suite=wheezy-backports&section=all&arch=any&searchon=names&keywords=linux-image-amd64),
    46  which is officially supported by Docker.
    47  
    48  ### Installation
    49  
    50  1. Install Kernel from wheezy-backports
    51   
    52      Add the following line to your `/etc/apt/sources.list`
    53  
    54      `deb http://http.debian.net/debian wheezy-backports main`
    55  
    56      then install the `linux-image-amd64` package (note the use of
    57      `-t wheezy-backports`)
    58   
    59          $ sudo apt-get update
    60          $ sudo apt-get install -t wheezy-backports linux-image-amd64
    61  
    62  2. Install Docker using the get.docker.com script:
    63   
    64      `curl -sSL https://get.docker.com/ | sh`
    65  
    66  ## Giving non-root access
    67  
    68  The `docker` daemon always runs as the `root` user and the `docker`
    69  daemon binds to a Unix socket instead of a TCP port. By default that
    70  Unix socket is owned by the user `root`, and so, by default, you can
    71  access it with `sudo`.
    72  
    73  If you (or your Docker installer) create a Unix group called `docker`
    74  and add users to it, then the `docker` daemon will make the ownership of
    75  the Unix socket read/writable by the `docker` group when the daemon
    76  starts. The `docker` daemon must always run as the root user, but if you
    77  run the `docker` client as a user in the `docker` group then you don't
    78  need to add `sudo` to all the client commands. From Docker 0.9.0 you can
    79  use the `-G` flag to specify an alternative group.
    80  
    81  > **Warning**: 
    82  > The `docker` group (or the group specified with the `-G` flag) is
    83  > `root`-equivalent; see [*Docker Daemon Attack Surface*](
    84  > /articles/security/#docker-daemon-attack-surface) details.
    85  
    86  **Example:**
    87  
    88      # Add the docker group if it doesn't already exist.
    89      $ sudo groupadd docker
    90  
    91      # Add the connected user "${USER}" to the docker group.
    92      # Change the user name to match your preferred user.
    93      # You may have to logout and log back in again for
    94      # this to take effect.
    95      $ sudo gpasswd -a ${USER} docker
    96  
    97      # Restart the Docker daemon.
    98      $ sudo service docker restart
    99  
   100  
   101  ## What next?
   102  
   103  Continue with the [User Guide](/userguide/).