# Bambuddy

Bambuddy is a self-hosted home automation app. A powerful, self-hosted print archive and management system for Bambu Lab 3D printers. It is open source and self-hosted, installable on Docker Hub, TrueNAS, Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/1693/bambuddy

## Description

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, Proxmox, Windows.

## Desktop and other devices

Windows.

## Health score

83/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 10 days ago)
- Popular: 70 (3,298 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)

## Links

- GitHub: https://github.com/maziggy/bambuddy
- Docker Hub: https://hub.docker.com/r/maziggy/bambuddy
- TrueNAS: https://apps.truenas.com/catalog/bambuddy/
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=bambuddy
- Official website: https://bambuddy.cool/index.html
- Unraid: https://ca.unraid.net/apps/bambuddy-128gupy1p8oqgy?q=Bambuddy
- desktop: https://github.com/maziggy/bambuddy/releases/latest
- Documentation: http://wiki.bambuddy.cool

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1693/bambuddy), the self-hosted and open-source app directory.
