Deploy Homelable

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

Deploy Homelable

/app/data

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

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.


Template Content

More templates in this category

View Template
Rootprint
Open-source logs and traces with full-text search on object-storage.

Rootprint
1
View Template
Pyroscope profiling
Protected continuous profiling with durable Pyroscope storage.

Anton Orel
1
View Template
SigOnly
Deploy SigNoz with a working demo app & config in one click

zoeyjones
21