Getting Started: How to Install Bambuddy (Docker)

[admin]

This guide walks you through installing Bambuddy using Docker — the recommended method.

Prerequisites

• Docker and Docker Compose installed on your system
• A Bambu Lab printer with Developer Mode enabled
• "Store sent files on external storage" enabled in Bambu Studio or OrcaSlicer
• Printer and server on the same local network

Installation

Option A: Pre-built Image (Fastest)

mkdir bambuddy && cd bambuddy
curl -O https://raw.githubusercontent.com/maziggy/bambuddy/main/docker-compose.yml
docker compose up -d

That's it! Open http://your-server-ip:5000 in your browser.

Option B: Build from Source

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

Multi-Architecture Support

Bambuddy runs on both AMD64 and ARM64 (Raspberry Pi 4/5). Docker will automatically pull the correct image.

macOS / Windows (Docker Desktop)

Docker Desktop doesn't support host networking. You'll need to enter your printer's IP address manually in Bambuddy settings instead of relying on auto-discovery.

Updating

docker compose pull
docker compose up -d

Daily Beta Builds

Want to try the latest features? Use the daily build tag:

image: ghcr.io/maziggy/bambuddy:daily

Note: Daily builds are never tagged as latest — you need to explicitly opt in.

First Steps After Install

1. Open Bambuddy in your browser
2. Go to Settings > Printers and add your printer's IP and access code
3. Your printer should appear on the dashboard within seconds
4. Start a print from your slicer — it will be automatically archived!

---

Having trouble? Check the Documentation or ask in the Help category.