Homebox | Inventory Management | Docker

Homebox: Sistema de inventario autohospedado en Docker para organizar tu hogar

Gestor de inventario minimalista y blazing-fast escrito en Go. Organiza ubicaciones, objetos, etiquetas. SQLite. Responsivo. Multi-usuario. QR codes automáticos. API REST. Open source.

¿Qué es Homebox?

Homebox es un sistema de inventario y organización autohospedable diseñado específicamente para usuarios domésticos que necesitan saber dónde está sus cosas sin complejidad operacional. A diferencia de Snipe-IT (pensado para IT corporativo) o soluciones cloud de pago, Homebox es simple, rápido, gratuito, open source, y se auto-hospeda fácilmente.

Características principales: Sistema de dos niveles: Ubicaciones (dónde están las cosas) + Objetos (qué son). Etiquetas para categorizar. Campos opcionales: garantía, aseguranza, precio de compra, estado de venta, etc. QR codes automáticos para cada página (útil para móvil). Fotos de objetos. Búsqueda y filtrado. Multi-usuario con grupos. Reportes exportables. Soporte multi-idioma. Responsive design (desktop, tablet, móvil). API REST. Backup trivial (SQLite en una carpeta). Go + SQLite = ultra-ligero (<50mb abierto="" agpl-3.0.="" c="" complejas.="" dependencias="" digo="" en="" p="" ram="" reposo="" sin="">

Para usuarios domésticos: Un solo lugar donde saber exactamente dónde está cada cosa. Sin complicaciones. Sin suscripción. Control total.

Características principales

Ubicaciones jerárquicas

Casa → Salón → Estantería. Anida ubicaciones sin límite.

Objetos simples

Nombre + Descripción = suficiente. Agrega más detalles opcionalmente.

Etiquetas flexibles

Categoriza: "Electrónica", "Libros", "Herramientas". Sin límite.

QR codes automáticos

Cada página tiene URL única y QR. Perfecto para móvil.

Fotos de objetos

Adjunta imágenes para referencia visual. Búsqueda por foto.

Búsqueda avanzada

Filtra por ubicación, etiquetas, campos. Resultados instantáneos.

Multi-usuario

Grupos de usuarios. Solo ven items de su grupo.

Campos personalizables

Precio, garantía, estado, fecha compra, etc. Elige lo que necesitas.

Reportes

Exporta CSV con inventario. Auditoria.

Responsive

Desktop, tablet, móvil. Una app que funciona everywhere.

Blazingly fast

Escrito en Go. <50mb p="" ram="" reposo.="" ultra-ligero.="">

Open source AGPL-3.0

Código abierto. Auditable. Contribuye.

Requisitos del sistema

Docker (o binario Go directo)
256 MB - 512 MB RAM (muy ligero)
500 MB - 2 GB espacio disco (SQLite + fotos)
Puerto 3100 o custom (mapeable en docker)
SQLite (embebido, no requiere Postgres)
Navegador moderno (cualquiera)

Ultra-ligero: Perfect para Raspberry Pi, NAS viejo, VPS barato. Footprint mínimo.

Instalación con Docker Compose

Paso 1: Crear carpeta de datos

mkdir -p ~/homebox-data

Paso 2: Crear docker-compose.yml

cat > docker-compose.yml << 'EOF' version: '3.8' services: homebox: image: ghcr.io/hay-kot/homebox:latest # image: ghcr.io/hay-kot/homebox:latest-rootless # Si necesitas rootless container_name: homebox restart: unless-stopped ports: - "3100:7745" volumes: - ./homebox-data:/data environment: # Zona horaria - TZ=Europe/Madrid # Log level: info, debug, trace - HBOX_LOG_LEVEL=info # Formato log: text, json - HBOX_LOG_FORMAT=text # Tamaño máximo upload (MB) - HBOX_WEB_MAX_UPLOAD_SIZE=10 EOF

Paso 3: Si usas rootless image (seguridad)

# Permisos para rootless (usuario 65532) mkdir -p ~/homebox-data sudo chown 65532:65532 -R ~/homebox-data

Paso 4: Iniciar Homebox

docker compose up -d # Espera 5-10 segundos docker compose logs -f homebox

Acceder

http://localhost:3100 - Dashboard Homebox

Primer login

Primera vez que accedas, Homebox te pedirá crear usuario admin. Crea tu cuenta y listo!

Primeros pasos

1. Crear ubicaciones

Dashboard → "Locations" o Settings → Locations
Crea ubicaciones: "Salón", "Cocina", "Dormitorio", "Garaje"
Dentro de "Salón": "Estantería 1", "Sofá", "TV Stand"
Homebox pre-seed con locations ejemplo, puedes borrarlas

2. Crear etiquetas

Settings → Labels
Crea: "Electrónica", "Libros", "Herramientas", "Ropa", "Decoración"
Úsalas luego para categorizar objetos

3. Agregar tu primer objeto

Dashboard → "+ Add Item" o "+ New Item"
Nombre: "Laptop Dell", "Libro Python", "Martillo", etc
Descripción: "Mi laptop de trabajo", "Referencia sobre Django", etc
Ubicación: Selecciona de la lista (ej: Salón → Estantería 1)
Etiquetas: "Electrónica" (si es laptop), "Libros" (si es libro)
Foto (opcional): Sube una imagen del objeto
Campos avanzados (opcional): Precio, Garantía, Comprado el, etc
Save

4. Ver QR code del objeto

Click en objeto
Arriba a la derecha: Icono QR
Muestra URL única y código QR
Usa QR desde móvil para acceso rápido

5. Buscar y filtrar

Buscador superior: busca por nombre, descripción
Filtros: por ubicación, etiquetas, estado
Resultados instantáneos

6. Agregar más usuarios

Settings → Users
Crea usuarios para familia (opcional)
Todos ven los objetos del grupo

7. Exportar reporte

Dashboard → "Export" o Settings
Descargar CSV de todo tu inventario
Para backup, o compartir

Casos de uso

Hogar desordenado: "¿Dónde está mi martillo?" → Busca en Homebox, encuentra en Garaje/Herramientas.
Mudanza: Inventaría cajas, ubicaciones, qué hay adentro. Déjalo durante la mudanza.
Homelab/Tech: Registra todos tus servidores, cables, equipos. Ubicaciones por rack.
Colecciones: Libros, películas, figuras, juegos. Catalogados y organizados.
Familia: Todos saben dónde están las cosas (herramientas, ropa, juguetes).
Aseguración: Prueba de propiedad. Fotos + descripción + precio. Para seguros.

HTTPS con Caddy (producción)

Caddyfile

homebox.tudominio.com { reverse_proxy localhost:3100 }

Acceso remoto seguro

https://homebox.tudominio.com con HTTPS automático

Acceso móvil

Desde cualquier dispositivo: accede a https://homebox.tudominio.com, escanea QR codes de objetos!

Gestión y mantenimiento

Ver logs

docker compose logs -f homebox

Backup de datos

cp -r ~/homebox-data ~/homebox-backup-$(date +%Y%m%d) # O backup del volumen Docker docker run --rm -v homebox_data:/data -v $(pwd):/backup alpine tar czf /backup/homebox-$(date +%Y%m%d).tar.gz -C /data .

Restore de backup

docker compose down rm -rf ~/homebox-data/* cp -r ~/homebox-backup-20260522/* ~/homebox-data/ docker compose up -d

Reiniciar

docker compose restart homebox

Actualizar a versión más reciente

docker compose pull docker compose up -d

Monitorear consumo

docker stats homebox # Verás: muy bajo CPU, < 50MB RAM

Comparativa con alternativas

vs Snipe-IT

Homebox gana: Simpler, faster, less cognitive overhead. Snipe-IT gana: Enterprise features, más robust, auditoría completa.

vs Notion/Obsidian database

Homebox gana: Específico para inventario, mejor UX. Notion gana: Más flexible, más features, integrations.

vs Spreadsheet (Excel/Sheets)

Homebox gana: Interface better, fotos, QR codes. Excel gana: Flexibility total.

Mejor para: Usuarios domésticos que quieren saber dónde está cada cosa. Minimalista. Rápido. Sin complicaciones. Sin suscripción.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Cómo instalar Homebox - Sistema de inventario autohospedado en Docker