How to set up Homepage with Docker Compose?

Use the provided Docker Compose example in the README, which maps volumes for config, sets environment variables like HOMEPAGE_ALLOWED_HOSTS, and optionally mounts the Docker socket for integration. Ensure your config directory exists and follow the security notes for proxying.

Homepage vs Heimdall: which is better for homelab dashboards?

Homepage is faster and more secure due to static generation and proxied requests, but lacks built-in auth and requires YAML config. Heimdall offers a web UI for setup and more dynamic features, but may be slower and less customizable. Choose based on preference for speed vs convenience.

Can Homepage display real-time data from services?

Yes, but with limitations: it fetches live data via proxied API calls, but the dashboard itself is static, so updates require periodic rebuilds or server restarts. For truly real-time updates, you'd need to manually trigger rebuilds or use external tools.

How to add custom CSS to Homepage dashboard?

Refer to the customization docs linked in the README: you can include custom CSS files in your config directory or inline styles via YAML settings, allowing theme overrides and personalization without modifying the core codebase.

Is Homepage secure without authentication?

No, the README stresses it must sit behind a reverse proxy with authentication and TLS if exposed to untrusted networks. The built-in host check is not sufficient for security, so external measures are mandatory for public deployments.

How to integrate Homepage with Plex and Sonarr?

Configure service widgets in your YAML files by adding API keys and URLs for Plex and Sonarr, as detailed in the service integrations section. Homepage will proxy requests to display media library stats or download queue status securely.

Homepage by gethomepage — Modern Static App Dashboard

What is Homepage by gethomepage?

Homepage is a highly customizable, static application dashboard that serves as a browser startpage or centralized hub for monitoring self-hosted services. It integrates with over 100 applications and Docker containers, displaying real-time data through widgets while ensuring security by proxying all API requests. The entire dashboard is configured via simple YAML files or automatically through Docker label discovery.

Target Audience

Homelab enthusiasts, sysadmins, and developers who self-host services and want a unified, performant dashboard to monitor their Docker containers, media servers, download clients, and other applications.

Value Proposition

Developers choose Homepage for its blend of speed (static generation), security (proxied API calls), and extensive out-of-the-box integrations with popular self-hosted apps, all while maintaining a simple YAML-based configuration that avoids complex setups.

A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations.

Use Cases

Best For

Creating a personalized browser startpage with live service status
Monitoring Docker container health and statistics in a unified dashboard
Aggregating data from multiple *arr apps (Sonarr, Radarr) and media servers (Plex, Jellyfin)
Building a homelab dashboard with weather, search, and system widgets
Deploying a lightweight, secure dashboard behind a reverse proxy or VPN
Customizing a dashboard with themes and layouts without writing code

Not Ideal For

Dynamic dashboards requiring real-time updates without manual rebuilds
Public-facing deployments without a reverse proxy for authentication and TLS
Teams preferring a graphical UI over YAML file configuration
Applications needing complex client-side interactivity or custom JavaScript logic

Pros & Cons

Pros

Blazing Fast Performance

The entire dashboard is statically generated at build time, ensuring instant load speeds and reduced server load, as highlighted in the README's focus on speed.

Proxied Security Model

All API requests are proxied through the server, keeping backend service keys hidden from client exposure, which enhances security for self-hosted environments.

Extensive Service Integration

Supports over 100 popular self-hosted apps like Plex and *arr suites, providing live data aggregation without custom coding, as listed in the service widgets section.

Seamless Docker Discovery

Automatically discovers and displays Docker container status via labels, reducing manual configuration for homelab users, detailed in the Docker integration features.

High Customization Flexibility

Configurable via YAML with support for custom themes, CSS, and layouts, allowing personalized dashboards without writing code, as emphasized in the customization section.

Cons

No Built-in Authentication

The README explicitly warns that Homepage lacks an authentication layer, requiring users to set up external reverse proxies or VPNs for secure public access, adding deployment complexity.

Static Generation Limitations

Real-time data updates require manual rebuilds or server restarts since the dashboard is generated at compile time, which can be cumbersome for frequently changing environments.

YAML Configuration Overhead

Configuration relies solely on YAML files, which can be error-prone and less accessible for users unfamiliar with YAML syntax, despite the extensive documentation.

Docker Socket Dependency Risk

For Docker integration, it requires access to the Docker socket (/var/run/docker.sock), which poses security risks if not properly isolated or managed in production setups.

What is Homepage by gethomepage?

Target Audience

Value Proposition

Use Cases

Best For

Creating a personalized browser startpage with live service status
Monitoring Docker container health and statistics in a unified dashboard
Aggregating data from multiple *arr apps (Sonarr, Radarr) and media servers (Plex, Jellyfin)
Building a homelab dashboard with weather, search, and system widgets
Deploying a lightweight, secure dashboard behind a reverse proxy or VPN
Customizing a dashboard with themes and layouts without writing code

Not Ideal For

Dynamic dashboards requiring real-time updates without manual rebuilds
Public-facing deployments without a reverse proxy for authentication and TLS
Teams preferring a graphical UI over YAML file configuration
Applications needing complex client-side interactivity or custom JavaScript logic

Pros & Cons

Pros

Blazing Fast Performance

The entire dashboard is statically generated at build time, ensuring instant load speeds and reduced server load, as highlighted in the README's focus on speed.

Proxied Security Model

All API requests are proxied through the server, keeping backend service keys hidden from client exposure, which enhances security for self-hosted environments.

Extensive Service Integration

Supports over 100 popular self-hosted apps like Plex and *arr suites, providing live data aggregation without custom coding, as listed in the service widgets section.

Seamless Docker Discovery

Automatically discovers and displays Docker container status via labels, reducing manual configuration for homelab users, detailed in the Docker integration features.

High Customization Flexibility

Configurable via YAML with support for custom themes, CSS, and layouts, allowing personalized dashboards without writing code, as emphasized in the customization section.

Cons

No Built-in Authentication

The README explicitly warns that Homepage lacks an authentication layer, requiring users to set up external reverse proxies or VPNs for secure public access, adding deployment complexity.

Static Generation Limitations

Real-time data updates require manual rebuilds or server restarts since the dashboard is generated at compile time, which can be cumbersome for frequently changing environments.

YAML Configuration Overhead

Configuration relies solely on YAML files, which can be error-prone and less accessible for users unfamiliar with YAML syntax, despite the extensive documentation.

Docker Socket Dependency Risk

For Docker integration, it requires access to the Docker socket (/var/run/docker.sock), which poses security risks if not properly isolated or managed in production setups.

Homepage by gethomepage

What is Homepage by gethomepage?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

Homepage by gethomepage

What is Homepage by gethomepage?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?