H

Homepage

29.9k stars·System Optimization·SHA-256 checksum verified

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)

Troubleshooting
Why 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.

GitHub Issue #4923
Troubleshooting
How 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 homepage

Or with Docker Compose:
docker compose restart homepage

2. 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.

GitHub Issue #6548

Tags

dashboarddockerself-hostedhomelabwidgets

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Deploy with Docker Compose: create docker-compose.yml (see docs)

4

Configure config folder using skeleton from src/skeleton

5

Run docker-compose up -d, access http://localhost:3000

Install Guide
  1. Deploy with Docker Compose: create docker-compose.yml (see docs)
  2. Configure config folder using skeleton from src/skeleton
  3. Run docker-compose up -d, access http://localhost:3000
File Integrity

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 Source
Environment Guide

Uninstall 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.

Project Info
LicenseMIT
Last Updated2026-10-15 05:21:55
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects