Skip to content
Boris Rybalkin edited this page Nov 16, 2026 · 23 revisions

To run Syncloud image under docker use the following command:

Start Syncloud container

docker run \
  --restart=always \
  --name=syncloud \
  --volume=/storage:/opt/disk/internal \
  --privileged \
  --detach=true \
  --network=host \
  syncloud/platform-bookworm:26.10.02

Where /storage is a directory on your host with ext4 filesystem

The image is multi-arch (amd64, arm64, arm), docker picks the right one for your machine. Latest tags: https://hub.docker.com/r/syncloud/platform-bookworm/tags

It should work on any Linux OS with docker installed.

Open https://localhost (or https://[IP of your docker machine]) in your browser and follow the activation procedure.

Limitations

The container shares the host network, so Syncloud needs ports 80 and 443 free on the host, and apps that use other ports (53 for Pi-hole, Syncthing, mail) clash with anything on the host already using them. Syncloud's own SSH and time services do not start when the host already runs them on ports 22 and 123, which is fine: use the host's SSH and clock.

Storage is the one host directory mounted above. The Storage page cannot manage, format or combine disks inside a container.

If you need separate IP, real disks or no port conflicts, run Syncloud in a VM instead (Virtual Box, VMware).

Old docker or cgroup v1 hosts

Docker 20.10+ on a cgroup v2 host (Debian 11+, Ubuntu 21.10+) needs nothing extra. Check with stat -fc %T /sys/fs/cgroup (cgroup2fs means v2).

Do not add --cgroupns=host, snapd inside the container fails with cannot parse pid "0".

On a cgroup v1 host use the systemd cgroup driver.

Edit: /etc/docker/daemon.json

{
  "exec-opts": ["native.cgroupdriver=systemd"]
}

Restart:

sudo systemctl restart docker

Otherwise container will not function after restart and you will see something like this in your /var/log/syslog:

kernel: systemd[1]: Failed to attach 1 to compat systemd cgroup /docker/.../init.scope: No such file or directory
kernel: systemd[1]: Failed to open pin file: No such file or directory
kernel: systemd[1]: Failed to allocate manager object: No such file or directory
kernel: systemd[1]: Freezing execution.

Zigbee usb device

To use host usb device add this to the docker command:

--device /dev/ttyUSB0:/dev/ttyUSB0

Clone this wiki locally