Deploy Homelable
Self-hosted homelab network diagram with inventory and live status checks
Just deployed
Just deployed
/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
- 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.
Template Content

