Shelf.nu: spullen bijhouden met QR-codes in plaats van een spreadsheet

Elke werkplaats, filmploeg, school en klusbedrijf heeft ergens een spreadsheet met wie welke boormachine, laptop of camera heeft. Shelf.nu vervangt die spreadsheet door QR-stickers: plak er een op, scan met je telefoon, en je ziet wie het spul heeft en tot wanneer.

Het project staat op ongeveer 2.600 sterren op GitHub, is uitgebracht onder AGPL-3.0, en de laatste release is [email protected] van 20 juli 2026. Dat was een beveiligingsrelease.

Waar die beveiligingsrelease over ging

De 2.0.1 repareerde een IDOR-lek: een verzoek waarin je het nummer van een object verandert en dan bij spullen van iemand anders uitkomt, omdat de server alleen controleerde of je ingelogd was en niet of dat ding van jou is.

Dat het gevonden en gerepareerd is, vind ik een pluspunt en geen minpunt. Elk project van deze omvang heeft zulke gaten; het verschil zit in of ze uitkomen en of er een release op volgt. Draai je Shelf al, dan is bijwerken naar 2.0.1 wel het eerste wat je vandaag doet.

Zelf hosten betekent ook zelf bijwerken. Een beveiligingsrelease die op je server blijft staan, helpt niemand.

Wat je nodig hebt om het zelf te draaien

Onderdeel Eis
Node.js 22.20 of hoger
pnpm 9.15.4 of hoger
Database en inloggen Een Supabase-project met PostgreSQL, auth en opslag
Docker Bestaat wel, maar wordt door de community onderhouden
Licentie AGPL-3.0

Die Supabase-eis is de belangrijkste van dit rijtje, en hij staat zelden in de tips die langskomen. “Self-hosted” betekent hier: jij draait de applicatie, maar je inloggen, database en bestandsopslag hangen aan een externe dienst. Dat is prima, alleen is het geen kastje in je eigen meterkast.

Ook goed om te weten: functies als uitleen en reserveringen werken realtime en hebben internet nodig. Een offline werkplaats is geen doelgroep.

Zelf hosten of hun cloud

Er is een betaalde clouddienst. Het gratis plan is voor één gebruiker en heeft een onbeperkt aantal items; wil je met meerdere mensen werken, dan zit je in Team of Enterprise. Een actueel bedrag voor Team kon ik niet uit een officiële bron bevestigen, dus kijk dat zelf na voor je rekent.

De AGPL is de tweede afweging. Voor intern gebruik maakt die licentie niets uit. Ga je Shelf aanpassen en als dienst aanbieden aan anderen, dan moet je je wijzigingen delen. Dat is precies waar die licentie voor bedoeld is.

Wat ik zou doen

Begin met tien items, niet met je hele inventaris. Print tien QR-stickers, plak ze op de spullen die het vaakst zoekraken, en kijk een maand of het gebruikt wordt. Een compleet ingevuld systeem dat niemand scant is duurder dan de spreadsheet.

Kies bewust tussen cloud en zelf hosten. Ben je met een paar mensen en wil je geen serverbeheer, neem de cloud. Wil je de data in eigen hand, reken dan het onderhoud mee: updates, back-ups en dat Supabase-project.

Zet een herinnering voor updates. Deze release laat zien dat er beveiligingsfixes komen. Eens per maand kijken of er een nieuwe versie is, is genoeg.

Veelgestelde vragen

Heb ik speciale scanners nodig?
Nee, de camera van een telefoon leest de QR-codes.

Kan ik het gratis gebruiken?
Ja. Zelf hosten mag onder AGPL-3.0, en in hun cloud is er een gratis plan voor één gebruiker.

Is dit een alternatief voor Snipe-IT?
Voor uitleen en reserveringen wel. Snipe-IT is ouder en meer op IT-inventaris gericht; Shelf leunt zwaarder op scannen en boeken.

Werkt het zonder internet?
Niet goed. Uitleen en reserveringen lopen realtime.

Bronnen