Spoolman

Spoolman is a self-hosted filament inventory manager built specifically for 3D printing enthusiasts and print farms. It replaces ad-hoc spreadsheets and handwritten notes with a structured, searchable database that tracks every filament spool from purchase through to the last gram. Material profiles store manufacturer, color, material type, density, and temperature settings so the right data is always at hand when setting up a new print. The lightweight SQLite backend runs without any external dependencies, making Spoolman easy to deploy as a single container on any VPS — no external database setup or complex configuration required.

Common Use Cases

Home hobbyists use Spoolman to track remaining filament across dozens of partially used spools, eliminating mid-print failures caused by running out of material unexpectedly. Print farms use it as a central inventory hub — operators scan the QR label on a spool before loading it, and Moonraker automatically records the estimated weight consumed once the print completes. Filament resellers and studios use Spoolman's material profiles to keep a product catalog of every material and color in stock, making it easy to look up technical specs during customer consultations. Makerspaces share a single Spoolman instance across multiple printers and members, with each spool tracked to a specific machine and user for accurate costing and restocking decisions.

Key Features

• Spool inventory management: record manufacturer, material, color, initial weight, and remaining filament for every spool
• Material and manufacturer profiles: store reusable temperature, density, and color settings that apply to all spools of a given type
• REST API: full CRUD API for spools, materials, and manufacturers accessible at /api/v1
• Klipper and Moonraker integration: native API support lets your printer register spool usage automatically on print completion
• QR code labels: generate scannable QR labels for each spool that open the full profile in any mobile browser
• WebSocket real-time updates: inventory changes are pushed to all clients instantly without page refresh
• Multiple database backends: SQLite by default; PostgreSQL, MariaDB, and CockroachDB supported for multi-user or high-write workloads
• Automatic SQLite backups: scheduled backups of the database file prevent accidental data loss
• Prometheus metrics endpoint: expose inventory statistics to Grafana and other monitoring tools via /metrics
• Runs as non-root user: the container process runs as a restricted app user, improving container security without any extra configuration

Why deploy Spoolman on Hostinger VPS

Running Spoolman on a Hostinger VPS gives your workshop or print farm a persistent, always-on inventory server that is accessible from any device on your network or the internet — no reliance on a PC that gets turned off, and no cloud subscription required. All inventory data stays on your server, with no third-party service seeing what materials you use or how much you print. The lightweight SQLite backend means even a small VPS plan handles a large spool catalog without performance concerns, and Traefik HTTPS routing gives you a secure, browser-accessible URL without any manual certificate management. When your farm grows, switching to PostgreSQL or MariaDB requires only a few environment variable changes and a data migration.