ConfigsApr 16, 2026·3 min read

Homepage — Highly Customizable Self-Hosted Dashboard

Homepage is a modern, fully customizable application dashboard and startpage. It integrates with 100+ services to display real-time status, weather, bookmarks, and widgets — all configured through simple YAML files.

AI Open Source
AI Open Source · Community
TL;DR
Homepage gives you a self-hosted dashboard with 100+ service integrations via YAML config.
§01

What it is

Homepage is a modern, fully customizable application dashboard and startpage. It integrates with 100+ services to display real-time status, weather, bookmarks, and widgets, all configured through simple YAML files. It serves as a central hub for your self-hosted services, showing at a glance whether everything is running.

Homepage targets homelab operators and self-hosters who run multiple services and need a single page to monitor and access them. Instead of bookmarking 20 different URLs, you have one dashboard that shows the status of each service.

§02

Why it saves time or tokens

Checking the status of multiple self-hosted services means opening each one individually. Homepage shows all services on one page with live status indicators, resource usage, and quick links. The YAML configuration is simple enough that AI assistants can generate service entries accurately, and adding a new service takes one YAML block.

§03

How to use

  1. Deploy Homepage with Docker: docker run -p 3000:3000 -v ./config:/app/config ghcr.io/gethomepage/homepage
  2. Edit services.yaml to add your services with URLs and API keys
  3. Configure widgets.yaml for weather, search, and system info widgets
§04

Example

# services.yaml
- Media:
    - Plex:
        icon: plex.svg
        href: https://plex.example.com
        description: Media Server
        widget:
          type: plex
          url: http://plex:32400
          key: your-plex-token
    - Navidrome:
        icon: navidrome.svg
        href: https://music.example.com
        description: Music Server

- Infrastructure:
    - Proxmox:
        icon: proxmox.svg
        href: https://proxmox.example.com
        widget:
          type: proxmox
          url: https://proxmox:8006
          username: api-user
          password: api-token
Widget TypeData Shown
Service statusUp/down indicator
Plex/JellyfinActive streams, library size
DockerContainer count, status
SystemCPU, memory, disk usage
WeatherCurrent conditions, forecast
§05

Related on TokRepo

§06

Common pitfalls

  • Service widgets require API keys or tokens for each service; gathering these takes time during initial setup
  • YAML indentation errors cause the entire config to fail; use a YAML validator before restarting
  • Homepage makes HTTP requests to each service for status; services behind authentication may require dedicated API tokens

Frequently Asked Questions

What services does Homepage integrate with?+

Homepage integrates with over 100 services including Plex, Jellyfin, Sonarr, Radarr, Pi-hole, AdGuard, Proxmox, Portainer, Traefik, Nginx Proxy Manager, and many more. Each integration provides a widget showing service-specific data like active streams, download status, or system metrics.

How does Homepage compare to Homarr or Dashy?+

All three are self-hosted dashboards. Homepage uses YAML configuration and focuses on service widgets. Homarr has a drag-and-drop UI editor. Dashy offers the most customization options with themes and layouts. Homepage is the simplest to configure for users comfortable with YAML.

Can Homepage show Docker container status?+

Yes. Homepage has a Docker integration that shows container status, health, and resource usage. You can configure it to auto-discover containers by label, so new containers appear on the dashboard automatically without editing YAML.

Does Homepage support authentication?+

Homepage itself does not have built-in authentication. For public-facing deployments, place it behind a reverse proxy with authentication (Authentik, Authelia, or basic auth). For local network use, most homelab operators run it without auth.

Can I customize the appearance?+

Yes. Homepage supports custom CSS, multiple color themes (light/dark), custom backgrounds, and layout options. You configure appearance in settings.yaml. The design is modern and responsive, working well on both desktop and mobile browsers.

Citations (3)
Related on TokRepo
Self-hosted toolsMonitoring toolsFeatured workflows

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Cucumber.js — BDD Testing with Plain Language Scenarios

Cucumber.js is a JavaScript implementation of Cucumber that runs automated tests written in Gherkin plain language.

AI Open Source

WireMock — Flexible API Mocking for Java and Beyond

WireMock is an HTTP mock server for stubbing and verifying API calls in integration tests and development.

AI Open Source

Google Benchmark — Microbenchmark Library for C++

Google Benchmark is a library for measuring and reporting the performance of C++ code with statistical rigor.

AI Open Source
◈Home🔍Search👤Me