github.com/0xfoo/docker@v1.8.2/docs/installation/SUSE.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Installation on openSUSE and SUSE Linux Enterprise"
     4  description = "Installation instructions for Docker on openSUSE and on SUSE Linux Enterprise."
     5  keywords = ["openSUSE, SUSE Linux Enterprise, SUSE, SLE, docker, documentation,  installation"]
     6  [menu.main]
     7  parent = "smn_linux"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # openSUSE
    12  
    13  Docker is available in **openSUSE 12.3 and later**. Please note that due
    14  to its current limitations Docker is able to run only **64 bit** architecture.
    15  
    16  Docker is not part of the official repositories of openSUSE 12.3 and
    17  openSUSE 13.1. Hence  it is necessary to add the [Virtualization
    18  repository](https://build.opensuse.org/project/show/Virtualization) from
    19  [OBS](https://build.opensuse.org/) to install the `docker` package.
    20  
    21  Execute one of the following commands to add the Virtualization repository:
    22  
    23      # openSUSE 12.3
    24      $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization
    25  
    26      # openSUSE 13.1
    27      $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization
    28  
    29  No extra repository is required for openSUSE 13.2 and later.
    30  
    31  # SUSE Linux Enterprise
    32  
    33  Docker is available in **SUSE Linux Enterprise 12 and later**. Please note that
    34  due to its current limitations Docker is able to run only on **64 bit**
    35  architecture.
    36  
    37  ## Installation
    38  
    39  Install the Docker package.
    40  
    41      $ sudo zypper in docker
    42  
    43  Now that it's installed, let's start the Docker daemon.
    44  
    45      $ sudo systemctl start docker
    46  
    47  If we want Docker to start at boot, we should also:
    48  
    49      $ sudo systemctl enable docker
    50  
    51  The docker package creates a new group named docker. Users, other than
    52  root user, need to be part of this group in order to interact with the
    53  Docker daemon. You can add users with:
    54  
    55      $ sudo /usr/sbin/usermod -a -G docker <username>
    56  
    57  To verify that everything has worked as expected:
    58  
    59      $ sudo docker run --rm -i -t opensuse /bin/bash
    60  
    61  This should download and import the `opensuse` image, and then start `bash` in
    62  a container. To exit the container type `exit`.
    63  
    64  If you want your containers to be able to access the external network you must
    65  enable the `net.ipv4.ip_forward` rule.
    66  This can be done using YaST by browsing to the
    67  `System -> Network Settings -> Routing` menu (for openSUSE Tumbleweed and later) or `Network Devices -> Network Settings -> Routing` menu (for SUSE Linux Enterprise 12 and previous openSUSE versions) and ensuring that the `Enable IPv4 Forwarding` box is checked.
    68  
    69  This option cannot be changed when networking is handled by the Network Manager.
    70  In such cases the `/etc/sysconfig/SuSEfirewall2` file needs to be edited by
    71  hand to ensure the `FW_ROUTE` flag is set to `yes` like so:
    72  
    73      FW_ROUTE="yes"
    74  
    75  
    76  **Done!**
    77  
    78  ## Custom daemon options
    79  
    80  If you need to add an HTTP Proxy, set a different directory or partition for the
    81  Docker runtime files, or make other customizations, read our systemd article to
    82  learn how to [customize your systemd Docker daemon options](/articles/systemd/).
    83  
    84  ## Uninstallation
    85  
    86  To uninstall the Docker package:
    87  
    88      $ sudo zypper rm docker
    89  
    90  The above command will not remove images, containers, volumes, or user created
    91  configuration files on your host. If you wish to delete all images, containers,
    92  and volumes run the following command:
    93  
    94      $ rm -rf /var/lib/docker
    95  
    96  You must delete the user created configuration files manually.
    97  
    98  ## What's next
    99  
   100  Continue with the [User Guide](/userguide/).
   101