---
title: "Deploy Homelable"
description: "Self-hosted homelab network diagram with inventory and live status checks"
category: "Observability"
url: https://railway.com/deploy/homelable
---

# Deploy Homelable

Self-hosted homelab network diagram with inventory and live status checks

**[Deploy Homelable on Railway](https://railway.com/template/homelable)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/homelable/manifest.json

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

## Template content

### frontend https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/homelable.png

- **Source:** https://github.com/aalfath/homelable-railway-template
- **Health check:** /api/v1/health
- **Public domain:** Yes

### backend https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/homelable.png

- **Source:** https://github.com/aalfath/homelable-railway-template
- **Health check:** /api/v1/health

## Documentation

# Deploy and Host Homelable on Railway

Homelable is an open-source, self-hosted visualizer for homelab infrastructure. You draw your network as an interactive diagram of servers, VMs, containers, switches and services, keep an inventory and documentation next to it, and see each node's live status from ping, HTTP, TCP or SSH checks.

## About Hosting Homelable

Homelable runs as two containers: a Python FastAPI backend with the API, scanner, status checker and a SQLite database, and an nginx frontend that serves the React app and proxies `/api` to the backend. This template deploys both from the official 3.7.1 images, pinned by digest. Only the frontend is public. It reaches the backend over Railway's private network. The SQLite database, uploaded floor plans and scan settings sit on a volume at `/app/data`. The admin password and the session signing key are generated for each deploy, so the upstream `admin`/`admin` default is never used. Network scans and status checks run from Railway, so they only reach public addresses, not your home LAN.

## Common Use Cases

* Draw and document a homelab or small office network as an interactive diagram
* Keep an inventory of servers, VMs, containers and their services in one place
* Watch the up or down status of public endpoints and services on a shared canvas

## Dependencies for Homelable Hosting

* Homelable backend (`ghcr.io/pouzor/homelable-backend:3.7.1`) with a volume for its SQLite database
* Homelable frontend (`ghcr.io/pouzor/homelable-frontend:3.7.1`), nginx serving the web app

### Deployment Dependencies

* Homelable on GitHub: https://github.com/Pouzor/homelable
* Installation guide: https://github.com/Pouzor/homelable/blob/main/INSTALLATION.md
* Release 3.7.1: https://github.com/Pouzor/homelable/releases/tag/v3.7.1
* Template source: https://github.com/aalfath/homelable-railway-template

### Implementation Details

Sign in with the user `admin` and the password in the backend service's `ADMIN_PASSWORD` variable. To change it, edit `ADMIN_PASSWORD` and redeploy the backend: it is bcrypt-hashed at every start. Changing `SECRET_KEY` signs everyone out.

Optional features are set as backend variables and need a redeploy: `LIVEVIEW_KEY` (read-only public canvas), `HOMEPAGE_API_KEY` (gethomepage widget), OpenID Connect (`AUTH_MODE=oidc` and the `OIDC_*` values) and Git sync (`GIT_SYNC_*`). See the upstream `.env.example`. The MCP server for AI clients is not included.

## Why Deploy Homelable 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 Homelable 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

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

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