MirrorNest
← All guides

Homepage

A fast, highly customizable self-hosted start page for your homelab — service links, live widgets (Docker container status, weather, RSS, and dozens of app integrations) defined in simple YAML files.

Target: Any Docker hostdashboardhomelabself-hostedOfficial homepage ↗Official docs ↗
This guide is synthesized from Homepage's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Create a config folder and run the container

    Homepage reads its layout from YAML files you edit directly -- no database, no setup wizard.

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

  2. 2Edit services.yaml and widgets.yaml

    services.yaml defines the link tiles grouped into sections; widgets.yaml adds live info panels (system resources, weather, search bar) at the top of the page.

    Mounting the Docker socket (read-only) lets Homepage auto-discover running containers and show their status directly, via labels you add to each container.

  3. 3Open the dashboard

    http://your-server-ip:3000