Docker Compose

Docker Compose

Stable compose deployment

mkdir printbuddy
cd printbuddy
curl -fsSLO https://raw.githubusercontent.com/vmhomelab/Printbuddy/main/docker-compose.yml
docker compose up -d

Minimal compose example

services:
  printbuddy:
    image: docker.io/vmhomelabde/printbuddy:latest
    container_name: printbuddy
    network_mode: host
    environment:
      - TZ=Europe/Berlin
      - PUID=1000
      - PGID=1000
      - PORT=8000
    volumes:
      - printbuddy_data:/app/data
      - printbuddy_logs:/app/logs
    restart: unless-stopped

volumes:
  printbuddy_data:
  printbuddy_logs:

Image tags

• Stable: docker.io/vmhomelabde/printbuddy:latest
• Development/testing: docker.io/vmhomelabde/printbuddy:dev

Optional self-update sidecar

Docker Compose installs can expose an Update now button in Printbuddy by adding the optional self-update sidecar. The sidecar is the only container with Docker socket access; the main Printbuddy app only talks to the sidecar over a token-protected local API.

Use this only on hosts where Printbuddy administrators are trusted to update/restart the configured Printbuddy service.

Important rebrand note

If you copied an older compose file from before the Printbuddy fork was restored, check it before starting containers:

grep -E 'maziggy|bambuddy|ghcr.io/.*/bambuddy' docker-compose.yml || true

Replace old references with:

image: docker.io/vmhomelabde/printbuddy:latest

and refresh from:

https://raw.githubusercontent.com/vmhomelab/Printbuddy/main/docker-compose.yml