gethomepage/homepage

What is it?

Key features

• 01Automatic service discovery from Docker container labels
• 02Proxied API integrations for over 100 services, keeping API keys server-side
• 03Information widgets for weather, time, date, search and system status
• 04Configuration via YAML files
• 05Custom themes, CSS, JavaScript and layouts
• 06Multilingual interface with Docker images for AMD64 and ARM64

Use cases

• Building a start page for a home server with links to all self-hosted services
• Monitoring Docker container status and resource usage from one dashboard
• Viewing download and media library status from *arr, Plex or Jellyfin in one place

Quick start

1. 1

   Run the Docker image with docker run (set HOMEPAGE_ALLOWED_HOSTS and adjust the config path)

   docker run --name homepage -e HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev -e PUID=1000 -e PGID=1000 -p 3000:3000 -v /path/to/config:/app/config -v /var/run/docker.sock:/var/run/docker.sock:ro --restart unless-stopped ghcr.io/gethomepage/homepage:latest

Things to know

• !Licensed under GPL-3.0, a copyleft license that requires derivative works to be open-sourced under the same terms.
• !If reachable from untrusted networks, it must sit behind a reverse proxy or VPN that enforces authentication and TLS.

In collections

Topics

FAQ

What is homepage?

A self-hosted application dashboard with Docker discovery, API-proxied widgets for 100+ services, and YAML-based configuration. Homepage is a customizable start page and application dashboard that you run yourself. It shows links to your services, live status and stats from Docker containers, and data widgets pulled from self-hosted apps such as the *arr suite, Plex, Jellyfin, qBittorrent and others, along with information widgets like weather, time, date and search.

Is homepage free to use? What license does it have?

homepage is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.

Is homepage still maintained?

Actively maintained. The last commit to homepage was on Oct 23, 2026.

What can I use homepage for?

Building a start page for a home server with links to all self-hosted services Monitoring Docker container status and resource usage from one dashboard Viewing download and media library status from *arr, Plex or Jellyfin in one place

How do I install homepage?

Run the Docker image with docker run (set HOMEPAGE_ALLOWED_HOSTS and adjust the config path): docker run --name homepage -e HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev -e PUID=1000 -e PGID=1000 -p 3000:3000 -v /path/to/config:/app/config -v /var/run/docker.sock:/var/run/docker.sock:ro --restart unless-stopped ghcr.io/gethomepage/homepage:latest

Where can I get homepage?

The source code and installation instructions are on GitHub: https://github.com/gethomepage/homepage