Homarr

Self-hosted dashboard for managing home server apps with 50+ integrations. Homarr is a unified, customizable dashboard with smart search, drag-and-drop editor, app integrations, and user management.

Features

Unified dashboard for all your self-hosted services
Smart search across your apps and services
Drag-and-drop editor for custom layouts
50+ app integrations with live status indicators
Multi-user support with role-based access
Responsive design — works on desktop and mobile
Lightweight and fast (< 100MB memory)
App store with community-contributed app tiles

Config

Variable	Description	Required	Default
`PORT`	HTTP port	No	`7575`
`AUTH_SECRET`	Session signing secret	Yes	—
`AUTH_PROVIDER`	Auth provider: credentials, ldap, oidc	No	`credentials`
`DB_DRIVER`	Database driver	No	`better-sqlite3`
`DB_HOST`	Database host	No	—
`DB_PORT`	Database port	No	—
`DB_NAME`	Database name	No	—
`DB_USER`	Database user	No	—
`DB_PASSWORD`	Database password	No	—
`TZ`	Timezone	No	`UTC`

License

This template is provided under the MIT license. Homarr itself is licensed under the MIT license.

Deploy and Host

About Hosting

Homarr is a lightweight, self-contained Node.js application that can run on minimal hardware. On Railway, it deploys instantly with no external database required — SQLite is included by default. You can optionally configure PostgreSQL or MySQL for multi-user production deployments.

Why Deploy

Deploying Homarr on Railway gives you:

Instant HTTPS via Railway domains
Zero-config deployment with the default SQLite backend
Automatic restarts and health checks
Easy scaling if you need PostgreSQL for larger deployments
Private networking for connecting to your other Railway services

Common Use Cases

Personal dashboard to organize all your self-hosted apps
Team dashboard for monitoring CI/CD pipelines and services
Home lab control panel with quick access to all services
Status board showing live metrics from integrated apps

Dependencies for

For a basic Homarr deployment, you only need the Homarr service itself. For advanced setups using an external database, you'll also need:

Deployment Dependencies

PostgreSQL or MySQL service (optional) — if you configure DB_DRIVER and connection variables, Homarr will use an external database instead of the built-in SQLite.