HomeBox

What it does

HomeBox is a home inventory. Record the things you own, with photos, receipts, prices and warranty dates, and say where each one lives: which room, shelf or box. Search finds anything in seconds, and printable QR labels help you find what is inside a box without opening it. It runs on your own computer or server, so the list of what you own stays private.

• Items, rooms, shelves and boxes, with photos, receipts and warranty dates
• Fast search and printable QR labels
• Maintenance reminders to Telegram, Discord, email and more
• Light enough to run on a Raspberry Pi

Great for: Households who want to know what they own, where it's stored and when warranties end; anyone preparing an insurance list.

Make it yours: ideas

Pick an idea to start from, or describe your own.

• Settings, no code Track the garage and the tools you lend out “Help me set up HomeBox for our garage: shelves as locations, a 'Power tool' type with serial number and purchase date, and a tag for things I've lent to neighbours.” Start with this idea
• Settings, no code QR labels for storage boxes in the loft “We have 30 boxes in the loft. Help me print a QR label for each so I can scan one with my phone and see what's inside.” Start with this idea
• Extend: themes, plugins, API Home maintenance reminders on Telegram “Remind me on Telegram to bleed the radiators every October and test the smoke alarms every month.” Start with this idea
• Code changes One-page insurance summary of valuables “Make a page I can print or save as PDF for my insurer: every item tagged 'valuable', with its photo, price, purchase date and serial number, and a total at the bottom.” Start with this idea
• Code changes Moving-house mode “We're moving next month. Let me mark each box as packed, loaded or unpacked, and show which room it goes to in the new house.” Start with this idea

How easy is it to adapt?

Entity types, templates, custom fields, tags, notifiers and labels are settings. Code changes touch a Go backend and a Nuxt frontend, with Swagger and TypeScript types generated between them (task swag, task typescript-types). Your AI always tries the gentlest step first, so your version stays easy to update.

1. 1

   Settings 3 options

   No code. Change it in the app or its config.

   • Make your own kinds of thing, such as "Garage shelf", "Power tool" or "Kids' clothes box", each with pre-filled fields.
   • Group items your way (e.g. "insured", "lent out", "for sale") and add fields such as serial number or size.
   • Pick a colour theme and the interface language for each person.
2. 2

   Extend 3 options

   Themes, plugins, webhooks and the API. Still no fork.

   • Send maintenance reminders to Telegram, Discord, ntfy, email and many more services.
   • Print QR labels for boxes and shelves; bulk-add items from a spreadsheet.
   • Scripts, phone shortcuts and links to other home apps.
3. 3

   Code 2 options

   Your AI edits the source for anything else.

   • New screens, such as a moving-house checklist or an insurance summary.
   • New data or behaviour. Every database change needs a migration for both SQLite and PostgreSQL.

Can I trust it?

• AGPL-3.0-only. Free to use and change. If you run a changed version that other people use over the internet (not just your own household), you must offer them your source code under the same licence. Private household use has no extra obligations.
• Your data: stores personal data, on your own device or server. SQLite database and uploaded files in the /data volume by default; PostgreSQL optional.
• Other services: Notification services (Discord, Telegram, ntfy, email, Pushover, webhooks and more, through Shoutrrr) (optional, free with most services); Email (SMTP) (optional, free with most providers); Meilisearch (optional, free (self-hosted))
• Pinned version 1fd2882. Every handover uses exactly this code, which we've reviewed.
• Set HBOX_OPTIONS_ALLOW_REGISTRATION=false after creating your accounts, and use HTTPS before exposing it to the internet.
• Your inventory shows what valuables you have and where. Keep it off the public internet if you can, and back it up.
• Notifier URLs can make HomeBox contact other machines on your network. The HBOX_NOTIFIER_* network settings in the docs limit this.

Did it work for people?

Tell us how it went

For your AI

The project pack has the pinned version, how to run it, and where to customise it. Your prompt links to it automatically.

https://handoff.bespokeai.software/p/homebox/1fd2882/pack.md

More for food & home

Home Assistant

Run your lights, heating and smart gadgets from one private app, with easy routines.

Food & home

Mealie

Your family's recipes, weekly meal plan and shopping list in one place.

Food & home

Paperless-ngx

Scan your household paperwork once and find any letter, bill or receipt in seconds.

Food & home