Homebox Home Inventory

beginner

Homebox inventory and organization system for home items tracking.

Overview

Homebox is a modern, self-hosted home inventory management system designed to help homeowners catalog, organize, and track their possessions digitally. Built with Go and Vue.js, this open-source application provides a comprehensive solution for documenting household items, their locations, values, warranties, and maintenance schedules through an intuitive web interface. The system addresses the common challenge of remembering what items you own, where they're stored, and their important details for insurance claims or general organization. Homebox operates as a single-container application with an embedded SQLite database, making it lightweight and perfect for home lab deployments. This Docker configuration provides a complete home inventory solution that runs efficiently on minimal hardware while offering features like QR code generation for physical item labeling, photo uploads, and detailed categorization systems. The application is ideal for homeowners looking to digitize their inventory records, families managing shared household items, or anyone seeking to maintain organized documentation of their possessions for insurance purposes or general peace of mind.

Key Features

Built-in QR code generation for creating physical labels that link to digital inventory records
Location-based organization system allowing hierarchical item placement tracking (rooms, shelves, containers)
Custom label system for flexible categorization and tagging of inventory items
Photo upload capability with configurable file size limits up to 10MB per image
CSV import and export functionality for bulk data management and backup purposes
Warranty and maintenance tracking with date-based reminders and documentation
Item value tracking with purchase date, cost, and depreciation information
Multi-user support with account-based access control and data separation

Common Use Cases

1Home insurance documentation requiring detailed inventory lists with photos and values
2Estate planning and asset cataloging for legal and financial record keeping
3Moving preparation with organized packing lists and item location tracking
4Warranty management for electronics, appliances, and other purchased goods
5Shared household inventory management for roommates or family members
6Collectibles and hobby item cataloging with detailed descriptions and valuations
7Business asset tracking for home offices or small business inventory needs

Prerequisites

Docker Engine 20.10 or higher with Docker Compose support
Minimum 512MB RAM available for the Homebox container and database operations
At least 1GB free disk space for application data and uploaded photos
Port 7745 available and not conflicting with other services
Web browser with JavaScript enabled for accessing the Vue.js interface
Basic understanding of inventory management concepts and QR code usage

For development & testing. Review security settings, change default credentials, and test thoroughly before production use. See Terms

docker-compose.yml

1services: 
2  homebox: 
3    image: ghcr.io/hay-kot/homebox:latest
4    container_name: homebox
5    environment: 
6      - HBOX_LOG_LEVEL=info
7      - HBOX_LOG_FORMAT=text
8      - HBOX_WEB_MAX_UPLOAD_SIZE=10
9    volumes: 
10      - homebox_data:/data
11    ports: 
12      - "7745:7745"
13    restart: unless-stopped
14    networks: 
15      - homebox-network
16
17volumes: 
18  homebox_data: 
19
20networks: 
21  homebox-network: 
22    driver: bridge

.env Template

.env

1# Homebox
2# No environment variables required for basic setup

Usage Notes

1UI at http://localhost:7745
2Create account on first visit
3Organize by locations, labels
4QR code labels for items
5CSV import/export

Quick Start

terminal

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  homebox:
5    image: ghcr.io/hay-kot/homebox:latest
6    container_name: homebox
7    environment:
8      - HBOX_LOG_LEVEL=info
9      - HBOX_LOG_FORMAT=text
10      - HBOX_WEB_MAX_UPLOAD_SIZE=10
11    volumes:
12      - homebox_data:/data
13    ports:
14      - "7745:7745"
15    restart: unless-stopped
16    networks:
17      - homebox-network
18
19volumes:
20  homebox_data:
21
22networks:
23  homebox-network:
24    driver: bridge
25EOF
26
27# 2. Create the .env file
28cat > .env << 'EOF'
29# Homebox
30# No environment variables required for basic setup
31EOF
32
33# 3. Start the services
34docker compose up -d
35
36# 4. View logs
37docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

terminal

1curl -fsSL https://docker.recipes/api/recipes/homebox-inventory/run | bash

Troubleshooting

Database locked errors during startup: Stop the container, check for corrupted SQLite files in the data volume, and restart with fresh database if needed
Photo upload failures with large files: Adjust HBOX_WEB_MAX_UPLOAD_SIZE environment variable or compress images before upload
QR codes not scanning properly: Ensure QR code labels are printed at sufficient size and resolution for your scanning device
CSV import failures with encoding issues: Save CSV files in UTF-8 encoding and verify column headers match Homebox expected format
Container fails to start with permission errors: Check that the data volume has proper read/write permissions for the container user
Interface loads but appears broken: Clear browser cache and cookies, then verify all JavaScript resources are loading without network errors

Community Notes

Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

Includes docker-compose.yml, .env template, README, and license

Components

homebox

Related Recipes

Ad Space

Shortcuts: C CopyF FavoriteD Download