github.com/hustcat/docker@v1.3.3-0.20160314103604-901c67a8eeab/docs/installation/linux/SUSE.md (about)

     1  <!--[metadata]>
     2  +++
     3  aliases = [ "/engine/installation/SUSE/"]
     4  title = "Installation on openSUSE and SUSE Linux Enterprise"
     5  description = "Installation instructions for Docker on openSUSE and on SUSE Linux Enterprise."
     6  keywords = ["openSUSE, SUSE Linux Enterprise, SUSE, SLE, docker, documentation,  installation"]
     7  [menu.main]
     8  parent = "engine_linux"
     9  +++
    10  <![end-metadata]-->
    11  
    12  # openSUSE and SUSE Linux Enterprise
    13  
    14  This page provides instructions for installing and configuring the latest
    15  Docker Engine software on openSUSE and SUSE systems.
    16  
    17  >**Note:** You can also find bleeding edge Docker versions inside of the repositories maintained by the [Virtualization:containers project](https://build.opensuse.org/project/show/Virtualization:containers) on the [Open Build Service](https://build.opensuse.org/). This project delivers also other packages that are related with the Docker ecosystem (for example, Docker Compose).
    18  
    19  ## Prerequisites
    20  
    21  You must be running a 64 bit architecture.
    22  
    23  ## openSUSE
    24  
    25  Docker is part of the official openSUSE repositories starting from 13.2. No
    26  additional repository is required on your system.
    27  
    28  ## SUSE Linux Enterprise
    29  
    30  Docker is officially supported on SUSE Linux Enterprise 12 and later. You can find the latest supported Docker packages inside the `Container` module. To enable this module, do the following:
    31  
    32  1. Start YaST, and select *Software > Software Repositories*.
    33  2. Click *Add* to open the add-on dialog.
    34  3. Select *Extensions and Module from Registration Server* and click *Next*.
    35  4. From the list of available extensions and modules, select *Container Module* and click *Next*.
    36     The containers module and its repositories are added to your system.
    37  5. If you use Subscription Management Tool, update the list of repositories at the SMT server.
    38  
    39  Otherwise execute the following command:
    40  
    41      $ sudo SUSEConnect -p sle-module-containers/12/x86_64 -r ''
    42  
    43      >**Note:** currently the `-r ''` flag is required to avoid a known limitation of `SUSEConnect`.
    44  
    45  The [Virtualization:containers project](https://build.opensuse.org/project/show/Virtualization:containers)
    46  on the [Open Build Service](https://build.opensuse.org/) contains also bleeding
    47  edge Docker packages for SUSE Linux Enterprise. However these packages are
    48  **not supported** by SUSE.
    49  
    50  ### Install Docker
    51  
    52  1. Install the Docker package:
    53  
    54          $ sudo zypper in docker
    55  
    56  2. Start the Docker daemon.
    57  
    58          $ sudo systemctl start docker
    59  
    60  3. Test the Docker installation.
    61  
    62          $ sudo docker run hello-world
    63  
    64  ## Configure Docker boot options
    65  
    66  You can use these steps on openSUSE or SUSE Linux Enterprise. To start the `docker daemon` at boot, set the following:
    67  
    68      $ sudo systemctl enable docker
    69  
    70  The `docker` package creates a new group named `docker`. Users, other than
    71  `root` user, must be part of this group to interact with the
    72  Docker daemon. You can add users with this command syntax:
    73  
    74      sudo /usr/sbin/usermod -a -G docker <username>
    75  
    76  Once you add a user, make sure they relog to pick up these new permissions.
    77  
    78  ## Enable external network access
    79  
    80  If you want your containers to be able to access the external network, you must
    81  enable the `net.ipv4.ip_forward` rule. To do this, use YaST.
    82  
    83  For openSUSE Tumbleweed and later, browse to the **System -> Network Settings -> Routing** menu. For SUSE Linux Enterprise 12 and previous openSUSE versions, browse to **Network Devices -> Network Settings -> Routing** menu (f) and check the *Enable IPv4 Forwarding* box.
    84  
    85  When networking is handled by the Network Manager, instead of YaST you must edit
    86  the `/etc/sysconfig/SuSEfirewall2` file needs by hand to ensure the `FW_ROUTE`
    87  flag is set to `yes` like so:
    88  
    89      FW_ROUTE="yes"
    90  
    91  ## Custom daemon options
    92  
    93  If you need to add an HTTP Proxy, set a different directory or partition for the
    94  Docker runtime files, or make other customizations, read the systemd article to
    95  learn how to [customize your systemd Docker daemon options](../../admin/systemd.md).
    96  
    97  ## Uninstallation
    98  
    99  To uninstall the Docker package:
   100  
   101      $ sudo zypper rm docker
   102  
   103  The above command does not remove images, containers, volumes, or user created
   104  configuration files on your host. If you wish to delete all images, containers,
   105  and volumes run the following command:
   106  
   107      $ rm -rf /var/lib/docker
   108  
   109  You must delete the user created configuration files manually.
   110  
   111  ## Where to go from here
   112  
   113  You can find more details about Docker on openSUSE or SUSE Linux Enterprise in the
   114  [Docker quick start guide](https://www.suse.com/documentation/sles-12/dockerquick/data/dockerquick.html)
   115  on the SUSE website. The document targets SUSE Linux Enterprise, but its contents apply also to openSUSE.
   116  
   117  Continue to the [User Guide](../../userguide/index.md).