Deploy HomeBox
Home inventory and asset tracking.
Just deployed
/data/
Deploy and Host HomeBox on Railway
HomeBox is a self-hosted inventory and organization system for the home user. It helps you catalog items, locations, tags, photos, documents, warranties, purchases, and maintenance details through a fast, responsive web interface. Its portable SQLite-backed design keeps household inventory data on infrastructure controlled by the deployer.
About Hosting HomeBox
Hosting HomeBox on Railway uses one immutable HomeBox 0.26.2 container, one persistent volume mounted at /data/, and a Railway HTTPS service domain targeting port 7745. The service keeps its SQLite database, uploaded images, and other application state on the volume. Railway checks / for readiness and restarts the container after failures. The API-key pepper is generated at deployment time rather than copied from a source installation. HomeBox is intended to run as one stateful instance; keep the volume backed up and avoid replicas that share it.
Common Use Cases
- Cataloging household items, locations, tags, photos, and custom fields
- Tracking warranties, purchase information, documents, and maintenance history
- Sharing a private inventory with family members through a self-hosted web application
Dependencies for HomeBox Hosting
ghcr.io/sysadminsmedia/homebox:0.26.2at the verified immutable digest- One Railway persistent volume mounted at
/data/ - One Railway-generated HTTPS service domain targeting port
7745 - A deployment-time generated
HBOX_AUTH_API_KEY_PEPPERfor API-key authentication
Deployment Dependencies
- HomeBox quick start
- HomeBox installation documentation
- HomeBox configuration documentation
- HomeBox 0.26.2 release
- HomeBox upstream repository
- Umbrel HomeBox package
Implementation Details
| Service | Image | Networking and health | Persistent storage |
|---|---|---|---|
HomeBox | ghcr.io/sysadminsmedia/homebox:0.26.2@sha256:b1ad7e3c63f732a5f6daa466e8116be4f545b3b120383a64dcb62beb00a660cc | Public port 7745; Railway HTTPS service domain; health path / | /data/ for the SQLite database, uploaded images, and application state |
The template keeps HomeBox's upstream container and uses the persistent /data/ mount from the Umbrel deployment contract. HBOX_AUTH_API_KEY_PEPPER is a deployment-time hexadecimal secret; do not rotate it on an initialized installation unless you intend to invalidate existing API keys.
Why Deploy HomeBox on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying HomeBox on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
