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

# Deploy HomeBox

Home inventory and asset tracking.

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

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### HomeBox

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

## Documentation

# 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.2` at 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_PEPPER` for API-key authentication

### Deployment Dependencies

- [HomeBox quick start](https://homebox.software/en/quick-start/)
- [HomeBox installation documentation](https://homebox.software/en/quick-start/install/)
- [HomeBox configuration documentation](https://homebox.software/en/quick-start/configure/)
- [HomeBox 0.26.2 release](https://github.com/sysadminsmedia/homebox/releases/tag/v0.26.2)
- [HomeBox upstream repository](https://github.com/sysadminsmedia/homebox)
- [Umbrel HomeBox package](https://github.com/getumbrel/umbrel-apps/tree/master/homebox)

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


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