Docker

openSUSE Support Database

Portal - SDB Categories - How to write an article

Tested on openSUSE

• Tumbleweed
• Leap 15.2
• 42.3
• 42.2

Recommended articles

• Docker Overview
• Get Started with Docker
• Docker Engine user guide

Related articles

• SDB:LXC
• Virtualization Guide

Warning: Currently there is a bug in docker that disables quotas globally in btrfs partitions. To preserve quota accounting for the root filesystem, as a workaround you can create a different partition (even btrfs) and mount on /var/lib/docker.

Installation

with YaST2

To install the docker and docker-compose packages start YaST2, select "Software" and start the module "Software Management". Search for docker and choose to install the Packages "docker" and "python3-docker-compose". (Even though the package is called "python3-docker-compose", it installs "docker-compose" binary). Then click "Accept", and if the installation was successful, "Finish".

To start the docker daemon during boot start YaST2, select "System" and start the module "Services Manager". Select the "docker" service and click "Enable/Disable" and "Start/Stop". To apply your changes click "OK".

To join the docker group that is allowed to use the docker daemon start YaST2, select "Security and Users" and start the module "User and Group Management". Select your user and click "Edit". On the "Details" tab select "docker" in the list of "Additional Groups". Then click "OK" twice.

Now you have to "Log out" of your session and "Log in" again for the changes to take effect.

with Command line

To install the docker and docker-compose packages:

zypper install docker python3-docker-compose

To start the docker daemon during boot:

sudo systemctl enable docker

To join the docker group that is allowed to use the docker daemon:

sudo usermod -G docker -a $USER

Restart the docker daemon:

sudo systemctl restart docker

Verify docker is running:

docker version

This will pull down and run the, "Hello World" docker container from dockerhub:

docker run --rm hello-world

Clean up and remove docker image we pulled down:

docker images

docker rmi -f IMAGE_ID

Where "IMAGE_ID" is the Id value of the "Hello World" container.

Use Docker

If you followed the instructions your openSUSE is ready to make use of docker containers. Dive into the great docker documentation and have a lot of fun...

References

• https://bugzilla.opensuse.org/show_bug.cgi?id=1175081