Home

Printbuddy Wiki

Printbuddy is a self-hosted print archive and management dashboard for Bambu Lab, Klipper/Moonraker, and PrusaLink printers.

Status: Printbuddy is still under active development. Test from the dev branch when validating new work; use main / latest only for stable deployments.

Wiki structure

Getting Started

• What is Printbuddy?
• Supported Printers
• Requirements
• First Setup

Installation

• Docker Compose
• Windows Installer
• Native Linux
• Development Builds

Configuration

• Add a Printer
• Bambu Lab Setup
• Klipper / Moonraker Setup
• PrusaLink Setup
• Camera Setup
• Network & Firewall

Features

• Dashboard
• Print Archive
• Printer Management
• Virtual Printer
• Queue / Review / Proxy Modes
• Backups

Maintenance

• Updating Printbuddy
• Self-update sidecar
• Backups & Restore
• Logs
• Migration from Bambuddy

Troubleshooting

• Docker Issues
• Windows Installer Issues
• Printer Connection Issues
• Virtual Printer Issues
• Camera Issues
• Common Error Messages

Development

• Branch Policy
• Dev Builds
• Contributing
• Repository Workflow

Correct project references

Use the Printbuddy fork/repository and image names:

Repository:      https://github.com/vmhomelab/Printbuddy
Container image: docker.io/vmhomelabde/printbuddy
Stable tag:      docker.io/vmhomelabde/printbuddy:latest
Dev tag:         docker.io/vmhomelabde/printbuddy:dev
Compose file:    https://raw.githubusercontent.com/vmhomelab/Printbuddy/main/docker-compose.yml

Do not use the old pre-fork image or raw URLs such as ghcr.io/maziggy/bambuddy or raw.githubusercontent.com/maziggy/bambuddy/....

Repository workflow

Development happens on dev first:

1. Commit and push work to dev.
2. Test from dev.
3. Merge approved changes into main.
4. Release from main.