MirrorNest
← Tous les 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.

Système : Any Docker hostdashboardhomelabself-hostedSite officiel ↗Documentation officielle ↗
Ce guide est élaboré à partir de la documentation officielle de Homepage, dont le lien figure ci-dessus — vérifiez toujours les noms exacts des paquets/versions avant d'exécuter ces commandes sur un serveur de production, car les versions de la distribution et du projet évoluent avec le temps.

  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