Skip to content

Docker with ZFS

When you already have a working ZFS pool (see here) and want to use Docker - it is good idea to configure them together.

Step 1 - Prepare filesystem

sudo zfs create -o mountpoint=/var/lib/docker mypool/docker-root
sudo zfs create -o mountpoint=/var/lib/docker/volumes mypool/docker-volumes
sudo chmod 700 /var/lib/docker/volumes

Optional: If you use zfs-auto-snapshot, you might want to consider this:

sudo zfs set com.sun:auto-snapshot=false mypool/docker-root
sudo zfs set com.sun:auto-snapshot=true mypool/docker-volumes

Create /etc/docker/daemon.json with the following content:

  "storage-driver": "zfs"

Step 2 - Install Docker


You can easily install docker by using armbian-config tool.

armbian-config -> software -> softy -> docker

Add /etc/apt/sources.list.d/docker.list with the following content:

deb [arch=arm64] focal stable
# deb-src [arch=arm64] focal stable

Proceed with installation:

sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
curl -fsSL | sudo apt-key add -
sudo apt update
sudo apt install docker-ce docker-ce-cli

You might want this:

sudo usermod -aG docker <your-username>

Voila! Your Docker should be ready! Test it:

docker run hello-world

Step 3 - Optional: Install Portainer

sudo zfs create mypool/docker-volumes/portainer_data
# You might omit the above line if you do not want to have separate dataset for the docker volume (bad idea).

docker volume create portainer_data
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Go to http://yourip:9000 and configure.

Page contributed by michabbs

Reference Armbian Forum Dicussion

Last update: February 26, 2021