sysadminsmedia

HomeBox: Organize and Track Your Home Inventory

HomeBox is a Go-based inventory and organization system for home users, with a web UI and SQLite storage. Self-host it to catalog belongings, find items, and track documents, warranties, purchases, and maintenance.

ActiveGoAGPL-3.0Self HostedWeb AppDocker
Stars
7.8k
Forks
618
Stars, last 30 days
+326
Last commit
1 day ago
Contributors
100+

Our take

Activeregular commits and releases

Health score

70/100

How it is scored
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 commit2026-11-05 (1 day ago)
Commits, last 90 days54
Releases, last 12 months21 (latest v0.27.1, 2026-10-23)
Contributors100+ (top contributor: 30% of commits)
Issues closed, last 90 days42 (typically closed in 2 days)
Pull requests merged, last 90 days32 (typically merged in 2 days)
Project age2 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.

Selected snapshot

Stars

7,904

Forks

624

Change 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.