HomeBox logo

HomeBox

Inventory and organization system built for the home user

Alternative to: Sortly, Encircle

HomeBox screenshotHomeBox screenshot

HomeBox is a self-hosted inventory and organization system designed for home users to keep track of their belongings. It lets you organize items into categories, locations, and tags, upload photos, and track purchase dates, prices, warranties, and maintenance schedules. Written in Go with an embedded SQLite database and web UI, it is lightweight and simple to deploy while remaining expandable for power users.

HomeBox Docker Compose example

Self-host HomeBox on your own server, homelab, or VPS starting from this Docker Compose example. It runs HomeBox in Docker containers using the official ghcr.io/sysadminsmedia/homebox:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  homebox:
    image: ghcr.io/sysadminsmedia/homebox:latest
    volumes:
      # Data directory: SQLite database and uploaded attachments/photos.
      - data:/data
    environment:
      # Log level: trace, debug, info, warn, error, or panic.
      HBOX_LOG_LEVEL: "info"
      # Log output format: text or json.
      HBOX_LOG_FORMAT: "text"
      # Maximum upload size in MB for attachments and item photos.
      HBOX_WEB_MAX_UPLOAD_SIZE: "10"
      # Allow new users to register accounts. Set to false once your accounts exist.
      HBOX_OPTIONS_ALLOW_REGISTRATION: "true"
    restart: unless-stopped

volumes:
  data:

Prefer a managed setup? WinterFlow installs, configures, and updates HomeBox for you using this same Docker Compose configuration.