guide · #homelab · 15 min

Create a Home Dashboard with Homepage

Cech Tech Reviews

Build a beautiful start page for all your self-hosted services and bookmarks. See the status of every service at a glance from a single dashboard.

1. 1

   Run Homepage in Docker

   docker run -d \
     --name homepage \
     --restart unless-stopped \
     -p 3000:3000 \
     -v ~/homepage/config:/app/config \
     ghcr.io/gethomepage/homepage:latest

2. 2

   Edit the configuration files

   Homepage uses YAML config files in ~/homepage/config. The main files are services.yaml (your service links), widgets.yaml (weather, search, etc.), and settings.yaml (theme and layout).

3. 3

   Add your services

   Edit services.yaml to add service cards with name, URL, and icon. Homepage supports hundreds of service integrations with live status checking.

4. 4

   Set it as your browser homepage

   Point your browser's start page to http://your-server-ip:3000. Every new tab shows your entire homelab at a glance.