Homebox — Self-Hosted Home Inventory and Organization System

Introduction

Homebox is a self-hosted inventory management application built for home users who want to catalog and organize their belongings. It tracks items by location, labels, and custom fields, with support for warranty dates, purchase prices, and QR code labels. The goal is to answer questions like where something is stored, when its warranty expires, and how much your household assets are worth.

What Homebox Does

• Catalogs household items with details like purchase date, price, warranty expiration, and serial numbers
• Organizes items by locations (rooms, shelves, boxes) and user-defined labels
• Generates QR code labels that link directly to item detail pages for quick scanning
• Provides asset value summaries and reports across locations and categories
• Supports file attachments for receipts, manuals, and photos per item

Architecture Overview

Homebox is written in Go with a SQLite database and a Vue.js front-end. The server binary handles both the API and serves the static front-end assets, resulting in a single-process deployment. Data is stored in a SQLite file within the mounted data volume. The API follows REST conventions, and the front-end communicates via JSON endpoints. The entire application runs in a single Docker container with minimal resource requirements.

Self-Hosting & Configuration

• Deploy with a single Docker run command or via Docker Compose with a volume for persistent data
• Set HBOX_WEB_MAX_UPLOAD_SIZE to control maximum file attachment size
• Optionally configure email SMTP settings for notifications and password resets
• Place behind a reverse proxy with SSL for secure external access
• Back up the SQLite database file in the data volume for disaster recovery

Key Features

• QR code label generation for physical labeling and quick mobile scanning
• Warranty and purchase tracking with upcoming expiration notifications
• Multi-user support with individual accounts sharing the same household inventory
• Custom fields for extending item metadata beyond the built-in schema
• CSV import and export for bulk data management and migration

Comparison with Similar Tools

• Grocy — broader household ERP covering groceries, chores, and recipes; Homebox focuses specifically on item inventory and asset tracking
• Snipe-IT — enterprise IT asset management with audit trails; Homebox is lighter and tailored for home use
• InvenTree — parts inventory for makers and hardware teams; Homebox targets general household organization
• Paperless-ngx — document management with OCR; Homebox tracks physical items rather than documents
• Notion/spreadsheets — flexible but not purpose-built; Homebox provides structured inventory features like QR labels and warranty tracking out of the box

FAQ

Q: Can multiple family members use the same Homebox instance? A: Yes. Homebox supports multiple user accounts that share the same inventory database, so the whole household can contribute.

Q: Does Homebox work on mobile? A: The web interface is responsive and works well on mobile browsers. You can scan QR code labels with your phone camera to jump directly to item pages.

Q: How do I print QR code labels? A: Homebox generates QR codes as images that you can print on standard label sheets. Each code links to the item's detail page on your instance.

Q: Can I import existing inventory data? A: Yes. Homebox supports CSV import, so you can prepare your data in a spreadsheet and upload it in bulk.

Sources

• https://github.com/sysadminsmedia/homebox
• https://homebox.software