---
title: Homepage
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, dashboard, moderne, api, integrations]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Dashboard, https://github.com/gethomepage/homepage]
---

# 📊 Homepage

> Le dashboard self-hosted le plus moderne du moment, pensé dès l'origine pour s'intégrer nativement avec des dizaines de services via leurs API.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Nom** | Homepage |
| **Site web** | https://gethomepage.dev |
| **GitHub** | https://github.com/gethomepage/homepage |
| **License** | GPL-3.0 |
| **Langage** | Node.js / React |
| **Étoiles GitHub** | 30 536 ⭐ |
| **Dernière MAJ** | 2026 (très active) |
| **Catégorie** | [[cat-dashboard\|Dashboard]] |
| **Image Docker** | ghcr.io/gethomepage/homepage |
| **Stack** | Next.js + containers |
| **Origine** | Communauté open source |
| **Multi-utilisateur** | Limité (mono-instance) |

## 📝 Description

Homepage se positionne comme **le successeur moderne** des dashboards classiques. Sa philosophie : au lieu d'afficher des iframes passives, il interroge directement les **API des services** que vous utilisez (Sonarr, Radarr, Plex, qBittorrent, Pi-hole, AdGuard Home, Proxmox, Docker, Unifi, etc.) pour afficher des **métriques temps réel** : statut, téléchargements actifs, espaces disque, températures CPU, sessions VPN, etc.

L'interface est **entièrement configurable en YAML** (services.yaml + widgets.yaml + settings.yaml) avec une grande flexibilité : layouts en colonnes, groupes, bookmarks, recherche rapide, fond d'écran dynamique, et plus de **100 intégrations natives** documentées.

⚠️ **Note importante** : Homepage évolue très vite. Les **breaking changes sont fréquents** entre versions majeures (migration de la v0.x vers v1.x, changements de schéma YAML). Il faut lire attentivement les release notes avant chaque upgrade et garder des sauvegardes de la configuration. La **dépendance aux API des services** implique également qu'un service modifié/cassé peut faire échouer l'affichage de son widget.

## 🚀 Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    restart: unless-stopped
    environment:
      HOMEPAGE_ALLOWED_HOSTS: gethomepage.local:8080
    ports:
      - 8080:3000
    volumes:
      - ./config:/app/config
      - /var/run/docker.sock:/var/run/docker.sock:ro  # pour le widget Docker
```

### Installation manuelle

Prérequis : Node.js 20+. Cloner le repo, `pnpm install`, `pnpm build`, `pnpm start`. Peu courant en production, Docker est la voie standard.

## ⚙️ Configuration

- **Trois fichiers YAML** : `settings.yaml` (global), `services.yaml` (intégrations), `widgets.yaml` (bookmarks/groupes)
- **Widgets info** : affichent statut détaillé avec API key + URL
- **Widgets bookmarks** : liens simples avec icônes
- **Groupes imbriqués** : pour organiser par catégorie
- **Recherche rapide** : intégrée (DuckDuckGo, Google, ou custom)
- **Authentification** : basique (utilisateur/mot de passe) ou via reverse proxy

## 🔗 Alternatives

- **Glance** — Plus léger, sans dépendance API
- **Dashy** — Riche, support multi-utilisateur
- **Homer** — Statique pur, idéal pour usage familial

## 🔒 Sécurité

- Supporte l'authentification HTTP basic (faible) ou OIDC via reverse proxy
- Le **socket Docker** en read-only reste sensible : ne l'exposer que si le widget Docker est utilisé
- **Variables d'environnement** pour les clés API : ne jamais les mettre en clair dans le YAML versionné
- Mettre à jour régulièrement (dépendances Node.js)
- Isoler derrière un VPN WireGuard ou Authelia pour l'accès distant

## 📚 Ressources

- [Site officiel](https://gethomepage.dev)
- [Liste des services supportés](https://gethomepage.dev/widgets/services/)
- [Documentation](https://gethomepage.dev/installation/)
- [GitHub](https://github.com/gethomepage/homepage)
- [Communauté Discord](https://discord.gg/k64vNRk2)

## 🔗 Pages Liées

- [[cat-dashboard]]
- [[app-glance]]
- [[app-dashy]]
- [[app-traefik]]
- [[securisation-home-lab]]
- [[recettes-docker-compose]]
- [[cat-reverse-proxy]]
