Repolode
Submit
sysadminsmedia

sysadminsmedia/homebox

Self-hosted home inventory system for tracking items, locations, documents, warranties and maintenance, continued from the original HomeBox project.

Open-source alternative to:SortlyHome Inventory

View on GitHubWebsite
Stars
7,624
Forks
605
Open issues
148
Last commit
20 hours ago

What is it?

HomeBox is a self-hosted inventory and organization app aimed at home users. It lets you record what you own, organize items into categories, locations and tags, and add custom fields for extra details.

Each item can carry photos, documents, warranty information, purchase dates and prices, and maintenance schedules. Search helps you find items quickly. The project is written in Go and uses SQLite with an embedded web UI, so it runs as a single container with a small memory footprint and is straightforward to back up.

The project is a continuation of the original HomeBox by hay-kot, and it is distributed as Docker images including rootless and hardened variants. The web interface is responsive for desktops, tablets and phones.

Key features

  • 01Organize items by categories, locations and tags
  • 02Add custom fields to store extra item details
  • 03Attach images, documents and warranty information to items
  • 04Track purchase dates, prices and maintenance schedules
  • 05Search across your inventory
  • 06Responsive web UI with SQLite storage and Docker deployment

Use cases

  • Cataloguing household belongings for insurance or moving
  • Keeping track of appliance warranties and manuals
  • Recording maintenance schedules for home equipment
  • Running a private inventory on a home server

Quick start

  1. 1

    Save the pepper to a local file

    openssl rand -base64 48 > hbox.pepper
  2. 2

    Restrict permissions on the pepper file

    chmod 400 hbox.pepper
  3. 3

    Create the data folder and run the container with Docker

    docker run -d --name homebox --restart unless-stopped --publish 3100:7745 --env TZ=Europe/Bucharest --env HBOX_AUTH_API_KEY_PEPPER=$(cat hbox.pepper) --volume /path/to/data/folder/:/data ghcr.io/sysadminsmedia/homebox:latest

Things to know

  • Requires Docker or a manually configured setup, with a secret pepper file to create before first run.

In collections

Self-hosted appsDatabases & SQL tools

Topics

#inventory#self-hosted#home-management#sqlite#golang#docker#hacktoberfest#homebox#selfhosted

FAQ

What is homebox?
Self-hosted home inventory system for tracking items, locations, documents, warranties and maintenance, continued from the original HomeBox project. HomeBox is a self-hosted inventory and organization app aimed at home users. It lets you record what you own, organize items into categories, locations and tags, and add custom fields for extra details.
Is homebox free to use? What license does it have?
homebox is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is homebox still maintained?
Actively maintained. The last commit to homebox was on Oct 23, 2026.
What can I use homebox for?
Cataloguing household belongings for insurance or moving Keeping track of appliance warranties and manuals Recording maintenance schedules for home equipment Running a private inventory on a home server
How do I install homebox?
Save the pepper to a local file: openssl rand -base64 48 > hbox.pepper Restrict permissions on the pepper file: chmod 400 hbox.pepper Create the data folder and run the container with Docker: docker run -d --name homebox --restart unless-stopped --publish 3100:7745 --env TZ=Europe/Bucharest --env HBOX_AUTH_API_KEY_PEPPER=$(cat hbox.pepper) --volume /path/to/data/folder/:/data ghcr.io/sysadminsmedia/homebox:latest
Where can I get homebox?
The source code and installation instructions are on GitHub: https://github.com/sysadminsmedia/homebox

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects