Bambuddy

A powerful, self-hosted print archive and management system for Bambu Lab 3D printers.

  • Home Automation
  • Media Applications
  • Media Servers
  • Productivity
  • Tools & Utilities
A powerful, self-hosted print archive and management system for Bambu Lab 3D printers. No cloud dependency, complete privacy, full control. NOTE: This container MUST run in HOST network mode for printer auto-discovery and local slicer integrations to work properly.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

83/100 Excellent

Maintained
100last commit 10 days ago
Popular
703,298 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 5 days ago

GitHub stars
3,298
Open issues
208
Last commit
2026-11-11
Latest release
v1.3.1
License
AGPL-3.0
Activity
steady

Checked 10 days ago - source: GitHub (maziggy/bambuddy)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Copy and edit .env before starting Run cp .env.example .env, then fill in the values for your printers or slicer services before starting BamBuddy. This .env file holds core settings, and missing or wrong values can stop it from connecting to the services it needs. source
  • Open the UI on port 8000 Before the Docker quick start, install Docker and Docker Compose (tools for running apps in isolated containers). After it starts, open http://localhost:8000 to use the interface, and open that port in your firewall only if you need it from another device. source
  • Manual start: keep the asyncio loop If you run the app manually with uvicorn (the Python web server), include --loop asyncio in the start command. This avoids a known bug where Virtual Printer FTP uploads can be cut off, especially on slower storage. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What .env setup is required before starting Bambuddy?

Copy .env.example to .env and fill in the printer or slicer service values before starting. Missing or wrong values can stop Bambuddy from connecting to the services it needs.

Does Bambuddy work with Docker bridge networking?

No, bridge networking breaks printer discovery and the Virtual Printer. Run the container so it shares the host's network.

Which port should I open for the Bambuddy UI?

The UI is available on port 8000. Open that port in your firewall only if you need to reach it from another device.

Why are H2 or P2S prints archived without thumbnails, filament total, or cost when using Bambu Studio?

Bambu Studio's Print button sends sliced files to the printer's internal memory, which Bambuddy cannot read. Start the print from Bambuddy, slice in OrcaSlicer, or use Send with External and start afterward, with a card or stick installed.

What flag should I add when running Bambuddy manually with uvicorn?

Include --loop asyncio in the start command. This avoids a known bug where Virtual Printer FTP uploads can be cut off, especially on slower storage.

Answers sourced from github.com, github.com, github.com, github.com, wiki.bambuddy.cool

Community

Collected 53 days ago - public community threads