Homebox

Overview

Field	Value
Purpose	Track assets and inventory
Business function	Hardware and equipment lifecycle management
Owner	IT Operations
Criticality	Medium
Image	ghcr.io/sysadminsmedia/homebox:latest
Route	ims.kh3group.com

Architecture

Homebox is published through Traefik, uses /root/homebox/data, and is configured for a database on backend.

Installation

Docker Compose at /root/homebox/docker-compose.yml.

Configuration

• Data: /root/homebox/data:/data
• Networks: aproxy, backend
• Container port: 7745
• Restart policy: unless-stopped
• Environment controls registration, mail, upload size, currency, and database access

Operational Procedures

cd /root/homebox
docker compose logs --tail=200 homebox
docker compose restart homebox
docker compose pull
docker compose up -d

Back up application data and its configured database. Keep device names, serial numbers, asset tags, locations, and lifecycle status aligned with the Hardware Inventory.

Troubleshooting

• Health check failing: inspect logs and database connectivity.
• Upload failure: check configured upload limit and storage capacity.
• Mail failure: check SMTP settings and network access.

Related Systems

• Hardware Inventory
• PostgreSQL