Homepage — Highly Customizable Self-Hosted Dashboard

Introduction

Homepage is a self-hosted dashboard that aggregates all your services, bookmarks, and widgets into a single beautiful page. It connects to over 100 services to show live status, stats, and information without you ever opening each app individually.

What Homepage Does

• Displays a unified dashboard with service status, bookmarks, and informational widgets
• Integrates natively with 100+ services including Docker, Portainer, Radarr, Sonarr, and Plex
• Shows real-time system resource usage, weather, search, and custom widgets
• Auto-discovers Docker containers and displays them with health status and quick links
• Supports multiple users and tabs for organizing services by category

Architecture Overview

Homepage is built with Next.js and runs as a Node.js application in Docker. Configuration is file-based using YAML files for services, widgets, bookmarks, and settings. The backend proxies API calls to configured services, caching responses to minimize load. Docker integration uses the Docker socket or TCP API for container auto-discovery.

Self-Hosting & Configuration

• Deploy via Docker or Docker Compose with a single config volume mount
• Configure services, widgets, and bookmarks through YAML files — no database required
• Set up service integrations using API keys stored in a separate credentials file
• Enable Docker auto-discovery by mounting the Docker socket into the container
• Customize themes, layouts, colors, and background images through settings.yaml

Key Features

• Over 100 native service integrations with live data and status indicators
• Docker container auto-discovery with health checks and quick-access links
• Beautiful responsive design with dark mode, custom themes, and multiple layouts
• Lightweight and fast — pages load instantly with server-side rendering
• Simple YAML-based configuration with no database or admin panel needed

Comparison with Similar Tools

• Dashy — More configuration options and a built-in config editor, but heavier and slower to load
• Homer — Simpler static dashboard without live service integrations or Docker discovery
• Heimdall — Application-focused with fewer widget types and no native Docker integration
• Flame — Minimal bookmark-style dashboard without service API integrations
• Homarr — Drag-and-drop editor with fewer native integrations but easier visual customization

FAQ

Q: Do I need a database to run Homepage? A: No. Homepage uses YAML configuration files exclusively. There is no database to set up or maintain.

Q: Can Homepage auto-detect my Docker containers? A: Yes. Mount the Docker socket and Homepage will automatically discover and display running containers with labels-based configuration.

Q: How do I add a service that is not natively supported? A: Use the custom API widget or the iframe widget to integrate any service that exposes a web interface or REST API.

Q: Does Homepage work on mobile devices? A: Yes. The dashboard is fully responsive and works well on phones and tablets in both portrait and landscape orientations.

Sources

• https://github.com/gethomepage/homepage
• https://gethomepage.dev