Home

Printbuddy Wiki

Printbuddy is a self-hosted 3D-printer management dashboard for makers, homelabs, and print farms that want one clean place to watch printers, track filament, archive jobs, and understand what happened after the print finished.

It brings Bambu Lab, Klipper / Moonraker, and PrusaLink style workflows together in one modern web UI instead of forcing every printer ecosystem to live in its own separate tool.

Try it first: the public demo is available at demo.printbuddy.tech.

What Printbuddy does

• Shows all configured printers in one fleet view with live progress, temperatures, connection state, job ETA, and quick actions.
• Tracks filament spools and inventory so you can see what is loaded, what is low, and how much material remains.
• Archives completed and failed prints with thumbnails, metadata, material, cost, duration, reprint actions, and scheduling options.
• Provides statistics for print time, success rate, filament usage, cost, printer activity, and printer-specific records.
• Supports queue/review workflows, virtual-printer handoff, backups, metrics, notifications, smart-plug automation, and Home Assistant integration paths.
• Runs self-hosted, usually with Docker Compose or the Home Assistant add-on, so your printer data stays under your control.

How it looks

Printer fleet dashboard

The printer dashboard gives you the operational view first: current jobs, progress, ETA, temperatures, connectivity, smart-plug state, loaded spool assignment, and printer actions.

Filament and spool inventory

The filament page tracks material, brand, color, remaining weight, spool location, loaded state, low-stock indicators, and label printing.

Print archive

The archive keeps previous prints searchable and reusable with model previews, printer/material filters, favorites, duplicate handling, reprint buttons, and schedule actions.

Statistics

Statistics turn the archive into useful feedback: total print time, filament consumption, failure rate, time accuracy, activity heatmaps, printer records, and cost tracking.

Who Printbuddy is for

Printbuddy is useful when you have more than one printer, mix different printer ecosystems, want a searchable print history, or want filament and print statistics without depending on a vendor cloud dashboard.

It is especially at home in a homelab setup: Docker, reverse proxy, Home Assistant, smart plugs, metrics, backups, and local-network printer control.

Start here

• What is Printbuddy?
• Supported Printers
• Requirements
• First Setup
• Docker Compose
• Home Assistant Add-on

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