# Deploy BamBuddy with Easypanel

URL: /templates/bambuddy

BamBuddy is a self-hosted command center for managing Bambu Lab 3D printers locally, with no cloud dependency. It supports single printers up to 40-printer farms and includes real-time monitoring, live camera streaming, print archive with 3D preview, timelapse editing, scheduling, multi-printer dispatch, server-side slicing of STL/3MF files, spool tracking with usage analytics, smart plug integration, HMS error alerts, and automated notifications.

## Installation notes

After deployment, access the BamBuddy web UI and run the setup wizard. Enable Developer Mode on your Bambu Lab printer from the Bambu Lab app (Settings - Device - Developer Mode) so BamBuddy can connect over your local network without the cloud. By default BamBuddy uses SQLite. To use PostgreSQL instead, add a DATABASE_URL environment variable in the format postgresql+asyncpg://user:pass@host:5432/bambuddy after deployment. Note: Virtual printer features (proxy mode, FTP, MQTT, RTSP camera relay) require additional port mappings and NET_BIND_SERVICE capability beyond what this template exposes; for full virtual printer support use the official Docker Compose with host network mode.

## Benefits

### Cloud-Free Printer Control

Manage your Bambu Lab printers entirely on your local network with no cloud dependency, using Bambu Lab's Developer Mode API.

### Full Print Lifecycle Management

Archive every print with a 3D preview, re-print with AMS filament remapping, edit timelapses, and track spool usage and costs.

### Advanced Automation

Schedule prints, dispatch jobs across multiple printers, auto power-off via smart plugs, and receive HMS error alerts and notifications.

### Server-Side Slicing

Slice STL and 3MF files directly in BamBuddy without needing the OrcaSlicer desktop app on every machine.

## Features

### Real-Time Monitoring

Live printer status, live camera streams, build plate detection, and HMS error alerts for all connected printers.

### Print Archive & 3D Preview

Every completed print is archived with a Three.js 3D preview, timelapse video, and full metadata for easy reference and re-printing.

### Spool & Inventory Tracking

Track filament spools with usage analytics, remaining weight estimates, and per-print cost accounting.

### Multi-Printer Dispatch

Queue and dispatch print jobs across multiple printers with AMS filament mapping and scheduling support.

### SQLite or PostgreSQL

Ships with SQLite for zero-config deployments; optionally connect an external PostgreSQL database for larger setups.

## Configuration

- `appServiceName` (App Service Name, required): bambuddy

- `appServiceImage` (App Service Image, required): ghcr.io/maziggy/bambuddy:0.2.4.4

- `timezone` (Timezone): UTC — Container timezone (e.g. Europe/Berlin, America/New_York)

## Services

- bambuddy: app (ghcr.io/maziggy/bambuddy:0.2.4.4)

## Resources

- [Website](https://bambuddy.cool)

- [GitHub](https://github.com/maziggy/bambuddy)

- [Documentation](https://github.com/maziggy/bambuddy/wiki)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/bambuddy)