OSS TanbouOn this page
Overview
Shelf is an IT asset and equipment management platform for laptops, production gear, tools, vehicles, and other physical inventory. It combines QR tags, bookings, custody, hierarchical locations, kits, custom fields, and audit history to track what exists, where it is, and who is using it.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Key features
Use QR scans to inspect, assign, and move assets
Generated QR codes let phone users open an asset and connect scanning to custody assignment, location updates, bookings, and other bulk workflows.
Sources: [2]
Prevent conflicts with bookings and reservations
Reservations carry checkout and return dates and can integrate with calendars to manage availability for shared equipment.
Sources: [2]
Adapt workflows with kits, custom fields, and audit history
Assets can be bundled into kits and enriched with serial numbers, warranty details, condition, and other custom metadata while activity logs preserve history.
Sources: [2]
Best fit
Fits teams replacing spreadsheets for shared IT and equipment inventory
It is relevant when inventory spans multiple locations, users, reservations, and custody changes that are difficult to maintain in spreadsheets.
Sources: [2]
Before adoption
Plan the Supabase/PostgreSQL dependency even for self-hosting
The development setup expects a Supabase project, and community Docker support still requires an external Supabase instance. Treat database and authentication operations as part of the deployment.
Sources: [2]
Apply the required database migration before upgrading to 2.3.0
The 2.3.0 release explicitly requires a database migration adding columns and indexes to UserBusinessIntel before starting the new application version.
Sources: [3]
Official sources
- [1]Shelf-nu/shelf.nu repository(2026-10-01)
- [2]Shelf README(2026-10-01)
- [3]Shelf 2.3.0 release(2026-10-01)
- [4]Shelf root license(2026-10-01)
- [5]Shelf Companion PolyForm Internal Use license(2026-10-01)
Supplemental curator note
Shelf tracks physical assets such as laptops, equipment, tools, and vehicles through QR-centric workflows covering reservations, assignment, checkout, and return. Most of the repository is AGPL-3.0, but apps/companion uses PolyForm Internal Use and cannot be distributed under those terms.
Try it in 3 steps
- 1
Clone Shelf and install dependencies
Use Node.js 22.20.0+ and pnpm 9.15.4+ to fetch the official repository and install monorepo dependencies.
git clone https://github.com/Shelf-nu/shelf.nu.git && cd shelf.nu && pnpm install - 2
Configure Supabase and set up the database
Add Supabase credentials and other required values to .env, then generate the Prisma client and apply migrations.
cp .env.example .env && pnpm webapp:setup - 3
Start the development server
Start the local HTTPS development server and open https://localhost:3000 to test asset, QR, and booking workflows.
pnpm webapp:dev
Growth
Growth trends · Last 30 days
3,022 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 776
- Open PRs
- 49
Development activity is still being collected.
Built with
Categories and tags
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- asset-management-system
- equipment-rental
- asset-management
- equipment-management
- iot
- iot-application
- assets-management
- itam
- equipment-scheduling
- Stars
- 3,022
- Forks
- 373
- Watchers
- 13
- Open issues
- 135
- Contributors
- 48
- Owner type
- Organization
- Primary language
- TypeScript
- License
- Not determined
- Repository last updated
- Oct 2, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- Ever Gauzy8,156 Stars
3 shared tag(s) · 2 shared category(s) · Same language
Unify ERP, CRM, HRM, ATS, projects, and time tracking under shared identity and permissions
TypeScript - Kan5,711 Stars
3 shared tag(s) · 2 shared category(s) · Same language
self-host a Trello-style board and control it through REST API or MCP
TypeScript - Plunk5,499 Stars
3 shared tag(s) · 2 shared category(s) · Same language
a self-hostable email platform combining API/SMTP delivery, campaigns, contacts, workflows, and AWS SES
TypeScript - Worklenz3,194 Stars
5 shared tag(s) · 2 shared category(s) · Same language
combine project management, time tracking, and resource planning in one self-hosted workspace
TypeScript - BigCapital3,919 Stars
4 shared tag(s) · 2 shared category(s) · Same language
self-host double-entry accounting, invoicing, inventory, reporting, and bank integrations
TypeScript - VerifyWise360 Stars
4 shared tag(s) · 2 shared category(s) · Same language
combine AI inventory, risk, compliance, and LLM evaluations in one governance platform
TypeScript
Report incorrect information
Tell us if any listing information is incorrect or outdated.