Deploy and Host HomeBox on Railway

What is HomeBox?

HomeBox is a self-hosted household inventory system for organizing assets, locations, labels, warranties, maintenance records, purchase details, attachments, and QR labels. It combines a responsive web interface with an embedded SQLite database, keeping personal inventory data and uploaded files in one portable service.

About Hosting HomeBox

This template runs the official HomeBox 0.26.2 container on port 7745 and publishes only its web interface through Railway HTTPS. HomeBox stores its SQLite database and attachments on one persistent volume mounted at /data. Railway generates the required API-key pepper, supplies safe application defaults, and leaves no manual deployment inputs. The service uses / for Railway liveness and exposes /api/v1/status for an application-level probe. Back up /data before upgrading, especially when moving from a pre-0.26 release because 0.26 introduced a substantial database and entity-model migration.

Common Use Cases

Catalog household equipment and valuables.
Track warranties, purchases, and maintenance.
Generate labels for storage locations and assets.

Dependencies for HomeBox Hosting

HomeBox 0.26.2 from the official SysAdmins Media container registry.
One Railway persistent volume mounted at /data.

Deployment Dependencies

Implementation Details

The template pins ghcr.io/sysadminsmedia/homebox:0.26.2@sha256:b1ad7e3c63f732a5f6daa466e8116be4f545b3b120383a64dcb62beb00a660cc. It preconfigures port 7745, text logging, a 10 MB upload limit, disabled optional analytics, UTC, and registration for first-account onboarding. Railway generates HBOX_AUTH_API_KEY_PEPPER as a sealed 64-character secret; rotating it invalidates issued API keys. After creating the first account, consider disabling public registration in a separately reviewed configuration change.

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.