---
title: "Deploy HomeBox"
description: "Home inventory and asset tracking with durable records and uploads."
category: "Other"
url: https://railway.com/deploy/homebox
---

# Deploy HomeBox

Home inventory and asset tracking with durable records and uploads.

**[Deploy HomeBox on Railway](https://railway.com/template/homebox)**

- **Creator:** Heron Technology
- **Category:** Other
- **Total deploys:** 1

## Template content

### HomeBox https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/homebox.svg

- **Image:** ghcr.io/sysadminsmedia/homebox:0.26.2@sha256:b1ad7e3c63f732a5f6daa466e8116be4f545b3b120383a64dcb62beb00a660cc
- **Health check:** /
- **Public domain:** Yes

## Documentation

# 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

* [HomeBox installation guide](https://homebox.software/en/installation/)
* [HomeBox configuration reference](https://homebox.software/en/configure/)
* [HomeBox 0.26.2 release notes](https://github.com/sysadminsmedia/homebox/releases/tag/v0.26.2)

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


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/homebox