Spoolman

Spoolman is een zelfgehoste filamentvoorraadbeheerder, speciaal 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

Hobbyisten gebruiken Spoolman om het resterende filament bij te houden van tientallen gedeeltelijk gebruikte spoelen, waardoor mislukte prints door onverwacht opraken van materiaal worden voorkomen. Printfarms gebruiken het als een centrale voorraadhub — operators scannen het QR-label op een spoel 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 spoel wordt gekoppeld aan een specifieke machine en gebruiker voor nauwkeurige kostenberekening en aanvulbeslissingen.

Belangrijkste functies

• Beheer van spoelvoorraad: registreer fabrikant, materiaal, kleur, startgewicht en resterend filament voor elke spoel
• Materiaal- en fabrikantprofielen: sla herbruikbare temperatuur-, dichtheid- en kleurinstellingen op die van toepassing zijn op alle spoelen van een bepaald type
• REST API: volledige CRUD API voor spoelen, materialen en fabrikanten toegankelijk via /api/v1
• Klipper- en Moonraker-integratie: native API-ondersteuning laat je printer het spoelgebruik automatisch registreren na voltooiing van de print
• QR-codelabels: genereer scanbare QR-labels voor elke spoel die het volledige profiel openen in elke mobiele browser
• WebSocket real-time updates: voorraadwijzigingen worden direct naar alle clients gepusht zonder paginauitvoering
• 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-rootgebruiker: 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 op het internet — geen afhankelijkheid van een pc die uitgeschakeld, en geen cloudabonnement vereist. Alle inventarisgegevens blijven op je server, zonder dat een externe dienst 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 farm groeit, vereist overschakelen naar PostgreSQL of MariaDB slechts enkele wijzigingen in omgevingsvariabelen en een datamigratie.