Our take
Activeregular commits and releases- Activity
- 68
- Community
- 88
- Issues
- 77
- Pull requests
- 45
+326 stars in the last 30 days
- More contributors than 78% of the projects we track
- Releases more often than 75% of the projects we track
HomeBox is a well-maintained, actively developed choice for self-hosted household inventory, with a broad contributor base and a clear focus on home use.
Good fit if
- You want a searchable home inventory with locations, images, and item-related records.
- You are comfortable running a Docker container and prefer SQLite-based storage.
- You want an actively maintained project with regular releases and contributions from many people.
Look elsewhere if
- You need an inventory system designed for business asset management rather than household organization.
- You cannot meet the obligations of the AGPL-3.0 license for your intended use.
- You need a feature or integration not described in the project documentation.
All health signals
| Last commit | 2026-11-05 (1 day ago) |
|---|---|
| Commits, last 90 days | 54 |
| Releases, last 12 months | 21 (latest v0.27.1, 2026-10-23) |
| Contributors | 100+ (top contributor: 30% of commits) |
| Issues closed, last 90 days | 42 (typically closed in 2 days) |
| Pull requests merged, last 90 days | 32 (typically merged in 2 days) |
| Project age | 2 years |
Checked on 2026-11-07 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
7,904Forks
624Change since Nov 17, 2026: +7 stars·+1 forks
Overview
HomeBox is a home inventory and organization system built with Go, SQLite, and an embedded web UI. It helps home users keep track of belongings and where they are, without requiring a separate database service or a complex setup.
It is designed to run on desktops, tablets, and smartphones, and can be deployed with Docker. Its focus is practical household organization: catalog items, search the inventory, and keep related records together.
Key Features
- Organize items by categories, locations, and tags.
- Add custom fields for details specific to your inventory.
- Search the inventory to find items quickly.
- Upload item images for identification.
- Keep documents and warranty information with items.
- Track purchase details and maintenance schedules.
- Use the responsive web interface on desktop, tablet, or phone.
Use Cases
- Homeowners can record belongings by room or storage location before a move or renovation.
- Households can find rarely used items without searching through boxes and closets.
- People managing valuable purchases can keep receipts, warranty information, and maintenance records alongside item details.
- Self-hosting users can maintain a household inventory on their own server and back up its data.
What you need
Detected in the repository
- Go (main language on GitHub)
- A Dockerfile, so it can run in a container; a Compose file sets up the related services
- Automated checks on GitHub Actions
License in plain words
AGPL-3.0network copyleft
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the license notice
- Share your changes: yes, the full source, also when people only use it over a network (e.g. as a hosted service)
- Includes an explicit patent grant from the contributors:
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
The project provides Docker images. Create a persistent data directory and an authentication pepper, then run the container:
openssl rand -base64 48 > hbox.pepper
mkdir -p ./homebox-data
docker run -d --name homebox --restart unless-stopped \
-p 3100:7745 \
-e HBOX_AUTH_API_KEY_PEPPER="$(cat hbox.pepper)" \
-v "$(pwd)/homebox-data:/data" \
ghcr.io/sysadminsmedia/homebox:latest
See the quick-start documentation and README for configuration details, including permissions and Docker Compose.
Considerations
- HomeBox is actively maintained, with frequent recent commits and releases. Its contributor base is broad rather than concentrated around one person.
- Docker is supported, and the application uses SQLite and an embedded web UI. The supplied setup requires persistent storage for its data.
- The project is licensed under AGPL-3.0. Review the license terms for your deployment, especially if you modify or provide the software as a network service.
- The project is framed specifically around home inventory and organization; the supplied materials do not establish business-focused inventory workflows or integrations.
Found this useful?
Share it with someone who would like HomeBox.