# bambu-controller

bambu-controller is a self-hosted communication app. Self-hosted web app to monitor and control Bambu Lab 3D printers in LAN Only Mode - no cloud, no account. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/9063/bambu-controller

## Description

Self-hosted web app to monitor and control Bambu Lab 3D printers in LAN Only Mode - no cloud, no account. Live camera (A1/P1 JPEG, X1/H2/P2S RTSPS), print job control, temperatures, fans, lights, motion, AMS, HMS alerts, SD card browser with timelapse player, G-code console, multi-user login and a security audit log. Before the first start: 1. Set APP_SECRET to a long random string (e.g. openssl rand -base64 32). It encrypts the printers' access codes; keep a copy, the database can't be decrypted without it. 2. The container runs as nobody:users (99:100). If the appdata folder already exists with another owner, run: chown -R 99:100 /mnt/user/appdata/bambu-controller On each printer enable LAN Only Mode (and Developer Mode on recent firmware); on X1-series printers also enable LAN Mode Liveview. Then open the web UI, create the first account and add the printers (they are discovered

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 1 day ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_8e275c78e9998866
- GitHub: https://github.com/mrquentin/bambu-controller

## Common questions

### What printer settings must I enable before adding a Bambu Lab printer?

Enable LAN Only Mode on the printer, and Developer Mode on recent firmware. On X1-series printers also enable LAN Mode Live for the camera.

### Why do I need to set APP_SECRET before first startup?

APP_SECRET encrypts the printers' access codes stored in the database. Keep a copy because the database cannot be decrypted without it.

### What ownership setting should I fix for the Docker appdata folder?

The container runs as UID/GID 99:100. If the appdata directory already exists with a different owner, change its ownership recursively to 99:100.

### Why do I need HTTPS to get push notifications?

Browsers allow push notifications only in a secure context, so the app must be served over HTTPS or localhost. You can use TLS_CERT_FILE and TLS_KEY_FILE or a reverse proxy with a valid certificate.

### Which live-camera stream does bambu-controller use for each printer family?

A1 and P1 printers use a JPEG stream. X1, H2, and P2S printers use RTSPS through ffmpeg.

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