Advisory: This site contains documentation for the v1.12 release candidate version of Docker Engine. For the Docker Engine v1.11 docs, see https://docs.docker.com/v1.11/. Docker for Mac and Docker for Windows are currently in Beta.
This page provides instructions for installing and configuring the latest Docker Engine software on openSUSE and SUSE systems.
Note: You can also find bleeding edge Docker versions inside of the repositories maintained by the Virtualization:containers project on the Open Build Service. This project delivers also other packages that are related with the Docker ecosystem (for example, Docker Compose).
You must be running a 64 bit architecture.
Docker is part of the official openSUSE repositories starting from 13.2. No additional repository is required on your system.
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:
Otherwise execute the following command:
$ sudo SUSEConnect -p sle-module-containers/12/x86_64 -r '' >**Note:** currently the `-r ''` flag is required to avoid a known limitation of `SUSEConnect`.
Install the Docker package:
$ sudo zypper in docker
Start the Docker daemon.
$ sudo systemctl start docker
Test the Docker installation.
$ sudo docker run hello-world
You can use these steps on openSUSE or SUSE Linux Enterprise. To start the
docker daemon at boot, set the following:
$ sudo systemctl enable docker
docker package creates a new group named
docker. Users, other than
root user, must be part of this group to interact with the
Docker daemon. You can add users with this command syntax:
sudo /usr/sbin/usermod -a -G docker <username>
Once you add a user, make sure they relog to pick up these new permissions.
If you want your containers to be able to access the external network, you must
net.ipv4.ip_forward rule. To do this, use YaST.
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.
When networking is handled by the Network Manager, instead of YaST you must edit
/etc/sysconfig/SuSEfirewall2 file needs by hand to ensure the
flag is set to
yes like so:
If you need to add an HTTP Proxy, set a different directory or partition for the Docker runtime files, or make other customizations, read the systemd article to learn how to customize your systemd Docker daemon options.
To uninstall the Docker package:
$ sudo zypper rm docker
The above command does not remove images, containers, volumes, or user created configuration files on your host. If you wish to delete all images, containers, and volumes run the following command:
$ rm -rf /var/lib/docker
You must delete the user created configuration files manually.
You can find more details about Docker on openSUSE or SUSE Linux Enterprise in the Docker quick start guide on the SUSE website. The document targets SUSE Linux Enterprise, but its contents apply also to openSUSE.
Continue to the User Guide.