selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

PrintGuard logo

Self-host PrintGuard

v2.6.4

On-device 3D print failure detection with auto-pause

ReleaseOpen SourceGPL-2.0
Updated9 hours ago
LanguagePython
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
363
Ports
8000 (dashboard, engine WebSocket, live video, device publishing), 8554 (RTSP input from cameras), 1935 (RTMP input from cameras), 9997 (MediaMTX API (internal)), 8888 (HLS muxer (internal))
Docker
ghcr.io/oliverbravery/printguard
Install with Docker
PrintGuard dashboard showing three cameras with one print mid-failure and auto-pausedMonitor detail panel with live risk score, printer controls, temperatures, and preheat presets3D print viewer showing sliced file toolpath with layer slider, print time, filament, and temperaturesDashboard with Spotify plugin panel and album cover art behind the dashboardCustomise mode showing drag-to-reorder and hide monitors and cameras, with pinningPrintGuard dashboard in light theme

What is PrintGuard?

PrintGuard executes on your own gear as a Docker container, macOS program, or Windows program. A miniature local vision model inspects every camera frame for printing faults. When a fault persists, it halts the print job through your print server and dispatches a snapshot to your phone. The dashboard presents live risk scores, temperatures, progress, and a 3D print library with toolpath previews. It connects to Home Assistant via MQTT, supplies HTTP and MCP interfaces for automation, and backs sandboxed JavaScript plugins. Themes cover light, dark, glass, and a custom editor. All computation remains on your network; frames never depart unless you elect to submit them for training. Licensed GPL-2.0-only with no paid tiers.

Should you self-host PrintGuard?

PrintGuard scores 52/100 on selfhost.directory (how scoring works) and ranks #11 of 22 in 3D Printing. It has 363 GitHub stars.

It shipped 18 stable releases in the past year. The latest, v2.6.4, came out on 27 October 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Octoprint (73/100, 9 166 stars). It scores higher overall, so compare the two before you pick. See PrintGuard vs Octoprint side by side.

Features

  • 3D print library with toolpath preview
  • Automatic print pause/cancel
  • Camera adjustment
  • Custom themes and layout
  • Fail-safe watchdog
  • Hardware Acceleration
  • Home Assistant Integration
  • Multi-camera scheduling
  • On-device failure detection
  • Per-monitor tuning
  • Printer control dashboard
  • REST API and MCP server
  • Sandboxed JavaScript plugins
  • Snapshot alerts

PrintGuard README

How to install PrintGuard

Install PrintGuard with Docker

docker run -d --name printguard --restart unless-stopped
-p 8000:8000 -p 8554:8554
--add-host host.docker.internal:host-gateway
-v printguard:/data
ghcr.io/oliverbravery/printguard

Images for amd64 and arm64 (Raspberry Pi 4/5). GPU variants: :latest-intel (with --device /dev/dri) and :latest-nvidia (with --gpus all).

PrintGuard releases & version history

More in 3D Printing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…