Deploy and Host Homepage on Railway

Homepage is a fast, static-feeling dashboard for your services and bookmarks. It has 100+ service widgets (Plex, Sonarr, Proxmox, Home Assistant, GitHub and more) that show live stats, with API keys kept on the server.

About Hosting Homepage

This template runs the official ghcr.io/gethomepage/homepage image as a single service with no database and no volume.

Homepage is configured with YAML files. Here each file comes from a Railway variable, written on every start: SETTINGS_YAML, SERVICES_YAML, WIDGETS_YAML and BOOKMARKS_YAML. Edit a variable in the Variables tab and Railway redeploys with the new config. No shell or file upload needed. Clear a variable to get Homepage's built-in example file.

Common Use Cases

A start page for everything you host on Railway and elsewhere.
A homelab dashboard with live widgets for your media, network and server apps.
A team links page with bookmarks and search.

Dependencies for Homepage Hosting

None. One container.

Deployment Dependencies

Upstream:
Configuration docs:
Service widgets:

Implementation Details

Variable	Default	Notes
`SERVICES_YAML`	a "Getting started" group	Your service tiles and widgets (`services.yaml`)
`SETTINGS_YAML`	dark theme, title "Homepage"	Title, theme, layout (`settings.yaml`)
`WIDGETS_YAML`	CPU/memory + search	Header info widgets (`widgets.yaml`)
`BOOKMARKS_YAML`	a few links	`bookmarks.yaml`
`HOMEPAGE_ALLOWED_HOSTS`	public domain + `healthcheck.railway.app`	Add your custom domain here, or the API returns 400
`HOMEPAGE_VAR_*`	(none)	Add these for secrets; reference as `{{HOMEPAGE_VAR_X}}`

Homepage has no login. Anyone with the URL can see the dashboard. Keep API keys in HOMEPAGE_VAR_* variables, not in the YAML.
Docker and Kubernetes auto-discovery need a socket or cluster access, so they don't work on Railway. List services in SERVICES_YAML instead.
Healthcheck: Railway probes /api/healthcheck.

Why Deploy Homepage on Railway?

Railway is a single platform for deploying your whole stack: servers, databases, AI agents and more. It handles the infrastructure, so you don't have to manage servers or configure scaling.

When you deploy Homepage on Railway, you're one step closer to running your full stack with minimal effort. Host your servers, databases, AI agents and more on Railway.