Docker Installation¶

Docker is the easiest way to run Bambuddy. One command and you're done!

Quick Start¶

git clone https://github.com/maziggy/bambuddy.git
cd bambuddy
docker compose up -d

Open http://localhost:8000 in your browser.

Configuration¶

docker-compose.yml¶

The default docker-compose.yml works out of the box:

services:
  bambuddy:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - ./bambuddy.db:/app/bambuddy.db
      - ./archive:/app/archive
      - ./logs:/app/logs
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin  # Your timezone

Environment Variables¶

Custom Port¶

To run on a different port, modify the ports mapping:

ports:
  - "3000:8000"  # Access on port 3000

Data Persistence¶

Three volumes store your data:

Updating¶

Pull Latest Changes¶

cd bambuddy
git pull origin main
docker compose build
docker compose up -d

One-Liner Update¶

cd bambuddy && git pull && docker compose up -d --build

Useful Commands¶

View Logs¶

# Follow logs
docker compose logs -f

# Last 100 lines
docker compose logs --tail 100

Stop/Start¶

# Stop
docker compose down

# Start
docker compose up -d

Rebuild (after changes)¶

docker compose up -d --build

Shell Access¶

docker compose exec bambuddy /bin/bash

Advanced Setups¶

Reverse Proxy (Nginx)¶

To run Bambuddy behind a reverse proxy with HTTPS:

server {
    listen 443 ssl http2;
    server_name bambuddy.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket support
        proxy_read_timeout 86400;
    }
}

Traefik Labels¶

If you're using Traefik:

services:
  bambuddy:
    build: .
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.bambuddy.rule=Host(`bambuddy.yourdomain.com`)"
      - "traefik.http.routers.bambuddy.entrypoints=websecure"
      - "traefik.http.routers.bambuddy.tls.certresolver=letsencrypt"
    # ... rest of config

Network Mode Host¶

Host network mode is required for printer discovery and camera streaming:

services:
  bambuddy:
    build: .
    network_mode: host
    # Note: ports mapping not needed with host mode

Printer Discovery in Docker¶

When running in Docker with network_mode: host, Bambuddy uses subnet scanning instead of SSDP multicast for printer discovery:

1. Click Add Printer on the Printers page
2. Bambuddy detects it's running in Docker and shows a subnet input field
3. Enter your network range (e.g., 192.168.1.0/24)
4. Click Scan Network - Bambuddy will probe each IP for Bambu printer ports (8883, 990)
5. Discovered printers appear in the list with their name and model

Troubleshooting¶

Container Won't Start¶

Check the logs:

docker compose logs bambuddy

Common issues:

• Port in use: Change the port mapping
• Permission denied: Check volume permissions

Can't Connect to Printer¶

Ensure your Docker network can reach your printer:

# Test connectivity from inside container
docker compose exec bambuddy ping YOUR_PRINTER_IP

If using bridge network mode and having issues, try network_mode: host.

Database Issues¶

If you need to reset the database:

docker compose down
rm bambuddy.db
docker compose up -d

Next Steps¶