# Homebox Home Inventory

> Homebox inventory and organization system for home items tracking.

- Category: Home Lab & Self-Hosting
- Difficulty: beginner
- Components: homebox
- Tags: homebox, inventory, organization, home, tracking
- Source: https://docker.recipes/homelab/homebox-inventory

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

## 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

## Use cases

- Home insurance documentation requiring detailed inventory lists with photos and values
- Estate planning and asset cataloging for legal and financial record keeping
- Moving preparation with organized packing lists and item location tracking
- Warranty management for electronics, appliances, and other purchased goods
- Shared household inventory management for roommates or family members
- Collectibles and hobby item cataloging with detailed descriptions and valuations
- Business 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

## docker-compose.yml

```yaml
services:
  homebox:
    image: ghcr.io/hay-kot/homebox:latest
    container_name: homebox
    environment:
      - HBOX_LOG_LEVEL=info
      - HBOX_LOG_FORMAT=text
      - HBOX_WEB_MAX_UPLOAD_SIZE=10
    volumes:
      - homebox_data:/data
    ports:
      - "7745:7745"
    restart: unless-stopped
    networks:
      - homebox-network

volumes:
  homebox_data:

networks:
  homebox-network:
    driver: bridge
```

## .env

```bash
# Homebox
# No environment variables required for basic setup
```

## Usage notes

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

## 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

