Question 1

How to set up Homepage with Docker Compose?

Accepted Answer

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.

Question 2

Homepage vs Heimdall: which is better for homelab dashboards?

Accepted Answer

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.

Question 3

Can Homepage display real-time data from services?

Accepted Answer

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.

Question 4

How to add custom CSS to Homepage dashboard?

Accepted Answer

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.

Question 5

Is Homepage secure without authentication?

Accepted Answer

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.

Question 6

How to integrate Homepage with Plex and Sonarr?

Accepted Answer

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

What is Homepage by gethomepage?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions