Knowledge Base

Information about, manuals and FAQs

User Tools

Site Tools


Docker for Debian 8

This page describes usage of docker in our VPS, i.e. under OpenVZ, which has its limitations, see below.

Docker can be used without any limitations using KVM.

Current state

Docker is working up until version 1.10. So far, nobody has been successful with newer versions, as it most likely requires patching kernel.


Docker runs well under Debian 8. Its installation is just a bit more complicated than the Docker documentation states.

1) vpsAdmin / VPS → Features → you need to turn on Bridge, iptables and TUN/TAP (the VPS restarts itself)

2) Run the following command:

echo "JoinControllers=cpu,cpuacct,cpuset freezer,devices" >> /etc/systemd/system.conf

3) Mount the following mount points:

2016-02-13 (profa) - tried on the Playground of a fresh install of Debian 8 – this step was not necessary

2016-08-11 (graywolf) - this step is not necessary. It is enough if you restart after the previous step.

mount -t tmpfs tmpfs /sys/fs/cgroup
mkdir /sys/fs/cgroup/freezer,devices
mount -t cgroup cgroup /sys/fs/cgroup/freezer,devices -o freezer,devices
mkdir /sys/fs/cgroup/cpu,cpuacct,cpuset
mount -t cgroup cgroup /sys/fs/cgroup/cpu,cpuacct,cpuset/ -o cpu,cpuacct,cpuset

4) Install the https module for apt:

apt-get update
apt-get install apt-transport-https

5) Add a mirror for Docker:

echo "deb debian-jessie main" > /etc/apt/sources.list.d/docker.list

6) Install Docker:

apt-get update
apt-get install docker-engine=1.10.3-0~jessie
apt-mark hold docker-engine

7) Change permissions:

usermod -aG docker $USER

8) Run Docker using the following sequence:

2016-02-13 (profa) - Docker started automatically after installation

systemctl daemon-reload
systemctl enable docker
systemctl start docker
systemctl status docker

It should run properly. You can test it:

docker run --rm hello-world 

If Docker doesn’t start, restart the VPS.

manuals/server/docker_for_debian.txt · Last modified: 2016/12/14 19:57 by Aither