World

Bambuddy requires Developer Mode to communicate directly with your printer over the local network, bypassing Bambu Cloud.

Why Developer Mode?

By default, Bambu Lab printers route everything through Bambu Cloud. Developer Mode enables local MQTT/FTP access, which Bambuddy uses for:

• Real-time status monitoring
• Sending print jobs directly
• Camera streaming
• Printer control (pause, resume, stop)

How to Enable It

1. On your printer's touchscreen, go to Settings
2. Navigate to Network or General (varies by model)
3. Find Developer Mode or LAN Only Mode
4. Enable it
5. Note the Access Code displayed — you'll need this in Bambuddy

Also Required: Store Sent Files on External Storage

In Bambu Studio or OrcaSlicer:

1. Go to your printer settings
2. Enable "Store sent files on external storage"

This ensures 3MF files are saved to the printer's SD card, which Bambuddy archives automatically.

Important Notes

• Developer Mode works alongside Cloud connectivity — you don't lose cloud features
• The Access Code changes if you reset it on the printer
• Your printer and Bambuddy server must be on the same local network

---

Once enabled, add your printer in Bambuddy: Settings > Printers > Add Printer — enter the IP address and access code.

If you want to access Bambuddy over HTTPS or via a domain name, you'll need a reverse proxy. Here's a working Nginx configuration.

Nginx Configuration

server {
    listen 80;
    server_name bambuddy.yourdomain.com;
    return 301 https://$host$request_uri;
}

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

    ssl_certificate /etc/letsencrypt/live/bambuddy.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bambuddy.yourdomain.com/privkey.pem;

    client_max_body_size 500M;
    proxy_read_timeout 300;
    proxy_connect_timeout 300;
    proxy_send_timeout 300;

    location / {
        proxy_pass http://127.0.0.1:5000;
        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;
    }
}

Important Notes

• WebSocket support is required — The Upgrade and Connection headers are essential for real-time printer status updates and camera streaming.
• Increase client_max_body_size — 3MF files can be large. 500M is a safe value for print farms.
• Increase timeouts — Some operations (firmware updates, large uploads) take time.

SSL Certificate with Let's Encrypt

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d bambuddy.yourdomain.com

---

For more details, check the Documentation.

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.

Bambuddy is a self-hosted print archive and management system for Bambu Lab 3D printers. It gives you full control over your printing workflow — no cloud dependency, no subscriptions, all your data stays on your own hardware.

Why Bambuddy?

• Own your data — All print history stored locally
• Works offline — Uses Developer Mode for direct printer control via local network
• Full automation — Schedule prints, auto power-off, get notified when done
• Multi-printer support — Manage your entire print farm from one interface

Key Features

Print Archive

Every print is automatically archived with its 3MF file, metadata, 3D preview, and photos. Search, tag, compare, and re-print any past job with a single click — complete with AMS filament mapping.

Real-Time Monitoring

Watch your printers live with camera streaming, status updates, fan monitoring, AMS status, and HMS error alerts. Control print speed, chamber lights, pause/resume, and even skip objects mid-print.

Print Queue & Scheduling

Drag-and-drop queue with multi-printer support. Schedule prints for specific times, use model-based routing for load balancing across your farm, and let smart plugs handle power management automatically.

Notifications

Get alerts via WhatsApp, Telegram, Discord, Email, Pushover, ntfy, or Home Assistant. Customize templates, set quiet hours, and receive per-filament usage details.

Spool Inventory

Track every spool with automatic consumption tracking, per-spool cost calculation, AMS slot assignment, and low-stock alerts. Bulk add up to 100 spools at once.

Virtual Printer & Remote Printing

Bambuddy can emulate a Bambu Lab printer on your network, letting you send prints directly from Bambu Studio or OrcaSlicer. The new Proxy Mode enables remote printing from anywhere via secure TLS relay.

Integrations

Spoolman sync, MQTT for Home Assistant/Node-RED, Prometheus metrics for Grafana, OrcaSlicer preset import, GitHub backup scheduling, and a comprehensive REST API.

---

Get started: https://github.com/maziggy/bambuddy
Documentation: https://wiki.bambuddy.cool
Discord: https://discord.gg/aFS3ZfScHM

We're excited to announce Bambuddy v0.2.3b3, packed with new features and improvements!

Highlights

SpoolBuddy Official Beta

SpoolBuddy integration is now in official beta. Write NFC tags, control the LCD display, and manage your spools with the companion hardware project.

Scheduled GitHub Backups

Automatically back up your cloud profiles, K-profiles, and settings to a GitHub repository on a schedule. Never lose your configuration again.

PostgreSQL Support

In addition to the built-in SQLite database, Bambuddy now supports PostgreSQL for larger deployments and print farms.

LDAP Authentication

Enterprise users can now connect Bambuddy to their existing LDAP/Active Directory for user management.

Queue Improvements

• SJF Scheduling — Shortest Job First scheduling for optimized queue throughput
• Auto G-code injection — Automatically inject custom G-code before/after prints
• Queue timeline view — Visual timeline of scheduled prints
• Staggered batch printing — Send prints to multiple printers with configurable delays

Other Notable Changes

• Bulk printer actions
• Improved AMS mapping for H2D dual-nozzle printers
• Better error handling across the board

---

Update now:

docker compose pull && docker compose up -d

Full changelog: https://github.com/maziggy/bambuddy/releases/tag/v0.2.3b3

Bambuddy already supports the new X2D

https://www.xda-developers.com/finally-have-full-control-bambu-lab-printer-ditched-bambu-cloud