explaingit

gethomepage/homepage

📈 Trending30,113JavaScriptAudience · vibe coderComplexity · 2/5ActiveLicenseSetup · moderate

TLDR

A self-hosted personal dashboard that displays all your services, their live status, and useful widgets, all from one web page on your home network.

Mindmap

mindmap
  root((homepage))
    What it does
      Personal dashboard
      Service status monitor
      Widget display
    Key features
      Auto-detect Docker services
      100+ app integrations
      YAML configuration
    Tech stack
      JavaScript frontend
      Static generation
      Docker support
    Use cases
      Home lab overview
      Service launcher
      Status monitoring
    Audience
      Self-hosters
      Home server users

Things people build with this

USE CASE 1

Create a centralized launch page for all your self-hosted services running at home.

USE CASE 2

Monitor real-time status and health of media servers, download managers, and home automation tools from one dashboard.

USE CASE 3

Automatically populate your dashboard by pointing Homepage at your Docker containers without manual setup.

USE CASE 4

Display weather, time, and custom widgets alongside your service shortcuts on a fast-loading start page.

Tech stack

JavaScriptYAMLDockerNode.js

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker to be installed and running; YAML configuration needed for services.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and license text.

In plain English

Homepage is a self-hosted personal dashboard and start page you can run on your own server or home network. Instead of opening a browser and hunting for bookmarks, you get a single web page that shows all your services, their live status, and useful information widgets like weather and time. It connects to over 100 self-hosted applications, such as media servers, download managers, and home automation tools, and pulls real-time data from them directly. If you run your services using Docker (a tool that packages apps in isolated containers), Homepage can automatically detect those services and add them to the dashboard without manual configuration. You set everything up through simple YAML files (a human-readable configuration format), and can customize the layout, theme, and displayed information extensively. The page loads very fast because it is statically generated, meaning the HTML is built ahead of time rather than assembled fresh on every visit. All communication with external services is routed through Homepage itself, so your private API keys (authentication tokens used to query services) are never exposed to the browser. Someone would use this when they self-host many services at home and want a clean, centralized overview to launch and monitor them from. It supports over 40 languages and runs on both standard desktop and ARM-based hardware like a Raspberry Pi.

Copy-paste prompts

Prompt 1
How do I set up Homepage as my home page and connect it to my Docker containers running on my home server?
Prompt 2
Show me how to configure Homepage with YAML to add custom widgets and organize my self-hosted services.
Prompt 3
What are the steps to deploy Homepage on a Raspberry Pi and make it accessible from my home network?
Prompt 4
How can I customize the theme and layout of my Homepage dashboard to match my preferences?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.