Skip to Content
MvpDots

Docker on the shared drive

Container images and volumes grow to tens of gigabytes. Here they live on the big shared drive, not on the Linux partition, and Docker refuses to start when that drive is missing.

NTFS can't host Docker's data directly (no Linux permissions, no overlay support). The trick is a Btrfs disk image stored on the NTFS drive, loop-mounted, with Docker's folders bind-mounted from it.

/mnt/shared/docker/docker.img   (a file on NTFS, formatted as Btrfs)
        └─ loop-mounted at /mnt/docker-e
              ├─ @docker      → bind-mounted on /var/lib/docker
              └─ @containerd  → bind-mounted on /var/lib/containerd

Steps

sudo systemctl stop docker.socket docker.service containerd
sudo mkdir -p /mnt/shared/docker /mnt/docker-e
sudo fallocate -l 120G /mnt/shared/docker/docker.img
sudo mkfs.btrfs -L docker-e /mnt/shared/docker/docker.img
echo loop | sudo tee /etc/modules-load.d/docker-e-loop.conf    # load the loop driver at boot
sudo modprobe loop
sudo mount -o loop,compress=zstd:1 /mnt/shared/docker/docker.img /mnt/docker-e
sudo btrfs subvolume create /mnt/docker-e/@docker
sudo btrfs subvolume create /mnt/docker-e/@containerd
sudo cp -a /var/lib/docker/.     /mnt/docker-e/@docker/
sudo cp -a /var/lib/containerd/. /mnt/docker-e/@containerd/

Then in /etc/fstab (back it up first):

/mnt/shared/docker/docker.img /mnt/docker-e btrfs loop,nodiscard,noatime,compress=zstd:1,space_cache=v2,nofail,x-systemd.requires-mounts-for=/mnt/shared 0 0
/mnt/docker-e/@docker     /var/lib/docker     none bind,nofail,x-systemd.requires-mounts-for=/mnt/docker-e 0 0
/mnt/docker-e/@containerd /var/lib/containerd none bind,nofail,x-systemd.requires-mounts-for=/mnt/docker-e 0 0

And make Docker wait for (and require) its data (files/docker-on-shared.conf in the playbook → /etc/systemd/system/docker.service.d/ and containerd.service.d/):

[Unit]
RequiresMountsFor=/var/lib/docker /var/lib/containerd

Compare the image, container and volume counts before and after the move. Delete the old copy only once they match.

Docker only when you need it

sudo systemctl disable docker.service docker.socket       # no autostart at boot
sudo systemctl start docker                                # when you need it
sudo systemctl stop docker.socket docker.service           # stop the socket too, or it wakes Docker again

/etc/docker/daemon.json: {"userland-proxy": false, "log-driver": "local", "log-opts": {"max-size": "10m", "max-file": "2"}}. After big rebuild sessions: docker builder prune -af.

Before and after

/etc/docker/daemon.json
+{
+  "userland-proxy": false,
+  "log-driver": "local",
+  "log-opts": { "max-size": "10m", "max-file": "2" }
+}

Check it

Terminal
findmnt /var/lib/docker          # source: /mnt/docker-e[/@docker]
systemctl cat docker | grep RequiresMountsFor
docker info --format '{{.DockerRootDir}}'

On this page