Troubleshooting

Troubleshooting

Check the running container

docker compose ps
docker compose logs --tail=200 printbuddy

Verify the image and compose source

grep -E 'image:|vmhomelab|printbuddy' docker-compose.yml

Expected Printbuddy image:

docker.io/vmhomelabde/printbuddy:latest

or, for development testing:

docker.io/vmhomelabde/printbuddy:dev

On Linux, network_mode: host is recommended for printer discovery, camera access, and virtual-printer workflows.

On Docker Desktop, use explicit port mappings instead because host networking is not available in the same way.

Useful commands

# Pull latest stable image
docker pull docker.io/vmhomelabde/printbuddy:latest

# Restart after config changes
docker compose up -d

# Follow logs
docker compose logs -f printbuddy