Spoolman

Spoolman is een zelf-gehoste filamentvoorraadbeheerder, specifiek gebouwd voor 3D-printliefhebbers en printfarms. Het vervangt ad-hoc spreadsheets en handgeschreven notities door een gestructureerde, doorzoekbare database die elke filamentrol volgt vanaf de aankoop tot de laatste gram. Materiaalprofielen slaan fabrikant, kleur, materiaalsoort, dichtheid en temperatuurinstellingen op, zodat de juiste gegevens altijd bij de hand zijn bij het instellen van een nieuwe print. De lichtgewicht SQLite-backend draait zonder externe afhankelijkheden, waardoor Spoolman eenvoudig als één container op elke VPS kan worden geïmplementeerd — geen externe database-instelling of complexe configuratie vereist.

Veelvoorkomende gebruiksscenario's

Thuis hobbyisten gebruiken Spoolman om het resterende filament bij te houden over tientallen gedeeltelijk gebruikte rollen, waardoor storingen tijdens het printen, veroorzaakt door onverwacht opraken van materiaal, worden voorkomen. Printfarms gebruiken het als een centrale voorraadhub — operators scannen het QR-label op een rol voordat ze deze laden, en Moonraker registreert automatisch het geschatte verbruikte gewicht zodra de print is voltooid. Filamentresellers en studio's gebruiken de materiaalprofielen van Spoolman om een productcatalogus bij te houden van elk materiaal en elke kleur op voorraad, waardoor het eenvoudig is om technische specificaties op te zoeken tijdens klantconsultaties. Makerspaces delen één Spoolman-instantie over meerdere printers en leden, waarbij elke rol wordt gevolgd naar een specifieke machine en gebruiker voor nauwkeurige kostenberekening en aanvulbeslissingen.

Belangrijkste kenmerken

• Beheer van filamentvoorraad: registreer fabrikant, materiaal, kleur, initiële gewicht en resterend filament voor elke rol
• Materiaal- en fabrikantprofielen: sla herbruikbare temperatuur-, dichtheid- en kleurinstellingen op die van toepassing zijn op alle rollen van een bepaald type
• REST API: volledige CRUD API voor rollen, materialen en fabrikanten toegankelijk via /api/v1
• Klipper- en Moonraker-integratie: native API-ondersteuning laat je printer het rolgebruik automatisch registreren na voltooiing van de print
• QR-codelabels: genereer scanbare QR-labels voor elke rol die het volledige profiel openen in elke mobiele browser
• WebSocket real-time updates: voorraadwijzigingen worden direct naar alle clients gepusht zonder de pagina te verversen
• Meerdere database-backends: SQLite standaard; PostgreSQL, MariaDB en CockroachDB ondersteund voor multi-user of hoge-schrijfbelastingen
• Automatische SQLite-back-ups: geplande back-ups van het databasebestand voorkomen onbedoeld gegevensverlies
• Prometheus metrics endpoint: toon voorraadstatistieken aan Grafana en andere monitoringtools via /metrics
• Draait als niet-root gebruiker: het containerproces draait als een beperkte app-gebruiker, wat de containerbeveiliging verbetert zonder extra configuratie

Waarom Spoolman implementeren op Hostinger VPS

Spoolman draaien op een Hostinger VPS geeft je werkplaats of printfarm een persistente, altijd-actieve voorraadserver die toegankelijk is vanaf elk apparaat in je netwerk of via internet — geen afhankelijkheid van een pc die uitgeschakeld, en geen cloudabonnement vereist. Alle inventarisgegevens blijven op jouw server, zonder dat een dienst van derden ziet welke materialen je gebruikt of hoeveel je print. De lichtgewicht SQLite-backend betekent dat zelfs een klein VPS-plan een grote spoelcatalogus aankan zonder prestatieproblemen, en Traefik HTTPS-routering geeft je een veilige, via de browser toegankelijke URL zonder handmatig certificaatbeheer. Wanneer je installatie groeit, vereist overstappen op PostgreSQL of MariaDB slechts enkele wijzigingen in omgevingsvariabelen en een gegevensmigratie.