Skip to content

Homebox

Docker Compose deployment guide for Homebox on Ubuntu.

Homebox is a lightweight self-hosted inventory and asset management system designed for homelab and household tracking.

Homebox screenshot from my homelab.

Official project:

Create the project folder

mkdir -p ~/docker/homebox
cd ~/docker/homebox

Create the Docker Compose file

Create:

nano docker-compose.yml

Paste:

services:
  homebox:
    image: ghcr.io/hay-kot/homebox:latest
    container_name: homebox

    ports:
      - "7745:7745"

    volumes:
      - ./data:/data

    environment:
      - TZ=America/Santo_Domingo

    restart: unless-stopped

Start Homebox

Run:

docker compose up -d

Access Homebox

Open:

http://YOUR_SERVER_IP:7745

Example:

http://192.168.1.50:7745

Notes

  • All Homebox data is stored in the data folder
  • Suitable for homelab equipment inventories and household asset tracking
  • Reverse proxy + HTTPS is recommended for internet access
  • Mobile-friendly interface works well on tablets and phones

Advanced Example (Reference Only)

This is my current Homebox setup.

It is NOT required for a standard installation.

services:
  homebox:
    image: ghcr.io/hay-kot/homebox:latest
    container_name: homebox

    stop_grace_period: 30s

    environment:
      - TZ=America/Santo_Domingo
      - HBOX_OPTIONS_ALLOW_REGISTRATION=false

    volumes:
      - /opt/docker/homebox/data:/data

    ports:
      - 7745:7745

    security_opt:
      - no-new-privileges:true

    restart: unless-stopped