Skip to content

The remote shape mounts the Docker socket for browser containers - #270

Merged
czpython merged 1 commit into
mainfrom
commonzenpython/remote-docker-socket
Aug 17, 2026
Merged

The remote shape mounts the Docker socket for browser containers#270
czpython merged 1 commit into
mainfrom
commonzenpython/remote-docker-socket

Conversation

@czpython

Copy link
Copy Markdown
Owner

Remote meant cloud sandboxes, so only the local overlay mounted the Docker socket. Browser-session containers run on the box's own daemon through the docker provider in either shape — seen on the live box after the drukbox tailnet fix (czpython/drukbox#9): ProviderTransportError: failed to connect to the docker API at unix:///var/run/docker.sock, because the drukbox containers had no socket at all.

The x-drukbox anchor in compose.remote.yaml now mounts /var/run/docker.sock, joins the socket's group (DRUKS_DOCKER_GID, the same knob the local overlay uses), and sets DOCKER_SSH_USERNAME: druks — the browser image runs sshd for the druks user, not the provider's root default. install.sh stamps DRUKS_DOCKER_GID for both shapes instead of only the local one.

Verified by rendering the merged config: both drukbox services (API + janitor) carry the mount, the gid, and the ssh user.

Live-box migration (one-time, current deploys don't refresh compose): copy the updated compose.remote.yaml, add DRUKS_DOCKER_GID=<socket gid> to .env, docker compose up -d drukbox drukbox-janitor.

Remote meant cloud sandboxes, so only the local overlay mounted the
socket. Browser-session containers run on the box's own daemon through
the docker provider in either shape, so the remote drukbox needs the
same mount, the socket's gid, and the browser image's ssh user.
install.sh stamps DRUKS_DOCKER_GID for both shapes now.
@czpython
czpython merged commit 4a374ce into main Aug 17, 2026
@czpython
czpython deleted the commonzenpython/remote-docker-socket branch August 17, 2026 11:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant