Homepage
A modern, fully static, fast, secure, highly customizable application dashboard with Docker auto-discovery and 100+ service integrations.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
A self-hosted dashboard that auto-discovers Docker containers and aggregates services with widgets.
Core Features
- Fully static site generated at build time for instant loading
- All API requests proxied to hide API keys and ensure security
- 100+ service integrations (Radarr, Sonarr, Plex, Jellyfin, etc.) and info widgets (weather, time)
- Automatic Docker service discovery via labels
- 40+ languages, highly customizable themes and layouts
What It Can't Do
- •Homepage does not include authentication. If exposed to untrusted networks, it must sit behind a reverse proxy enforcing authentication, TLS, and strict Host header validation. Do not expose port directly to the public internet.
Use Cases
- Homelab service overview dashboard
- Internal enterprise app portal
- NAS Docker service monitoring
Detailed Introduction
Homepage is a modern application dashboard that is fully static and built at compile time for instant load times. It proxies all API requests to backend services, keeping API keys hidden and ensuring security. It supports over 100 service integrations (Radarr, Sonarr, Plex, Jellyfin, etc.) and information widgets (weather, time, search). Configuration is done via YAML files or automatically via Docker labels. It includes full i18n support for 40+ languages and is highly customizable with themes, custom CSS/JS, and layouts. Built for AMD64 and ARM64, it runs as a Docker container or from source.
Troubleshooting & FAQ (2)
TroubleshootingWhy does fiveColumns show only 4 columns for root services after upgrading Homepage to v1.0.0?
This is a regression in Homepage v1.0.0: fiveColumns: true is ignored for root-level layout groups, while nested groups can still display correctly. As a workaround, switch from the latest image tag to the dev tag, which contains the fix, then pull and recreate the container. Keep fiveColumns: true in settings.yaml. Alternatively, upgrade to a stable release containing the fix once available.
TroubleshootingHow to fix the Omada widget 'API Error: Unexpected error' / 'Unexpected token <' in Homepage when multiple devices open the dashboard?
This is caused by concurrent Omada logins overwriting Homepage's shared cookie jar. Each viewer logs in every 5 seconds; an in-flight request can then send a token from one session with the session cookie from another, causing Omada to return an HTML login page instead of JSON.
Immediate workaround:
1. Restart the Homepage container, not the Omada container:
docker restart homepageOr with Docker Compose:
docker compose restart homepage2. Until the widget is fixed, avoid opening Homepage on multiple devices simultaneously. Multiple tabs on the same device do not trigger the issue as reliably.
3. Restarting Omada does not clear the bad state in Homepage.
A permanent fix requires changing the Omada widget to reuse/cache a session instead of logging in on every 5-second poll, or isolating cookies/tokens per request rather than using a process-global cookie jar.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Deploy with Docker Compose: create docker-compose.yml (see docs)
Configure config folder using skeleton from src/skeleton
Run docker-compose up -d, access http://localhost:3000
- Deploy with Docker Compose: create docker-compose.yml (see docs)
- Configure config folder using skeleton from src/skeleton
- Run docker-compose up -d, access http://localhost:3000
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Stop and remove container: docker-compose down, delete config directory and image.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
2 FAQs
Similar Projects
Huginn
Huginn lets you build agents that automate online tasks. Events propagate through a directed graph. Monitor web, Twitter, email, and more.
RSSHub
RSSHub is the world's largest open-source RSS network. It generates RSS feeds from virtually any website, with over 5,000 instances and a thriving community. Perfect for aggregating social media, news, blogs, and more.
PowerToys
A set of utilities for power users to tune and streamline their Windows experience for greater productivity.