Homepage

Monitoring

A clean, YAML-configured start page for all your homelab services.

Homepage is a fast, highly customisable start page for your homelab. You describe your services, widgets and bookmarks in a few YAML files and it renders a clean dashboard with icons, live status checks, system resource widgets, a search box and light and dark themes. More than a hundred service integrations (Proxmox, Jellyfin, Pi-hole, Docker and many more) can show live stats, and the config reloads without a restart. It stores no data in a database, so backing it up is just copying the config folder.

License

GPL-3.0

GitHub stars

33,290

Official website

https://gethomepage.dev

Source code

https://github.com/gethomepage/homepage

Compatibility

Architectures

amd64, arm64

Database

Stateless

Resource footprint

256 MB RAM · 1 CPU

Very light. In our test LXC (1 core, 512 MB) the container used about 140 MB of RAM and idled at 0% CPU while showing 14 services with status checks, system resources and a search box. The image is about 255 MB. Config changes to services.yaml and widgets.yaml apply without a restart.

Proof of Work Gallery

Dashboard
Light theme
Mobile

Deployment

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      # Hostnames you open the dashboard from, otherwise you get a host validation error.
      HOMEPAGE_ALLOWED_HOSTS: "localhost:3000,192.168.1.40:3000"
    volumes:
      - ./config:/app/config
      - ./images:/app/public/images

Alternative to

Heimdall, Dashy, Homarr