111 lines
3.9 KiB
Markdown
111 lines
3.9 KiB
Markdown
---
|
|
title: Homer
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, dashboard, statique, yml, leger]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Dashboard, https://github.com/bastienwirtz/homer]
|
|
---
|
|
|
|
# 📊 Homer
|
|
|
|
> Dashboard statique ultra-léger, configuré en un simple fichier YAML — idéal pour qui veut juste un point d'entrée vers ses services sans dépendance ni complexité.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Nom** | Homer |
|
|
| **Site web** | https://homer-demo.netlify.app |
|
|
| **GitHub** | https://github.com/bastienwirtz/homer |
|
|
| **License** | Apache-2.0 |
|
|
| **Langage** | HTML / Vanilla JS (build statique) |
|
|
| **Étoiles GitHub** | 11 383 ⭐ |
|
|
| **Dernière MAJ** | 2025-2026 (maintenance lente) |
|
|
| **Catégorie** | [[cat-dashboard\|Dashboard]] |
|
|
| **Image Docker** | b4bz/homer |
|
|
| **Stack** | Aucun runtime serveur (Nginx + assets) |
|
|
| **Origine** | Projet de Bastien Wirtz |
|
|
| **Multi-utilisateur** | Non |
|
|
|
|
## 📝 Description
|
|
|
|
Homer est un **dashboard 100% statique** : pas de backend, pas de base de données, pas de service à maintenir. Toute la configuration tient dans un unique fichier `config.yml` listant vos services (nom, URL, icône, couleur, groupe, sous-services).
|
|
|
|
C'est la solution idéale pour : un **dashboard familial** simple, un **lancement rapide** d'un point d'entrée homelab, ou un **point de départ** qu'on enrichit au fil du temps. Le rendu est propre, responsive, et consomme très peu de ressources (un container nginx suffit).
|
|
|
|
⚠️ **Note importante** : Homer est volontairement **minimaliste et statique**. Pas de widgets dynamiques, pas de status checking, pas d'API. C'est une force (simplicité, robustesse) mais aussi une limite. Le projet est aussi en **maintenance lente** : peu de releases, peu de nouvelles fonctionnalités. Pour un dashboard plus riche, préférer Dashy, Homepage ou Glance.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Via Docker (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
homer:
|
|
image: b4bz/homer
|
|
container_name: homer
|
|
restart: unless-stopped
|
|
ports:
|
|
- 8080:8080
|
|
volumes:
|
|
- ./config.yml:/www/config.yml:ro
|
|
- ./assets:/www/assets
|
|
- ./theme-custom.css:/www/theme-custom.css:ro # optionnel
|
|
```
|
|
|
|
### Installation manuelle
|
|
|
|
```bash
|
|
# Build statique
|
|
git clone https://github.com/bastienwirtz/homer.git
|
|
cd homer
|
|
npm install
|
|
npm run build
|
|
# Servir le dossier dist/ derrière Nginx
|
|
```
|
|
|
|
## ⚙️ Configuration
|
|
|
|
- **Fichier `config.yml`** unique, sections : `title`, `subtitle`, `colors`, `services`, `groups`, `links`
|
|
- **Icônes** : auto-détection par favicon, ou chemin custom
|
|
- **Groupes** : pour organiser les services (Réseau, Media, Dev, Domotique...)
|
|
- **Message de bienvenue** : configurable en haut
|
|
- **Recherche** : barre de recherche client-side (filtrage instantané)
|
|
- **Custom CSS** : pour override des couleurs/typo
|
|
|
|
## 🔗 Alternatives
|
|
|
|
- **Glance** — Plus moderne, avec widgets dynamiques
|
|
- **Dashy** — Plus riche, multi-utilisateur
|
|
- **Homepage** — Plus intégré aux API de services
|
|
|
|
## 🔒 Sécurité
|
|
|
|
- **Aucun backend** = surface d'attaque quasi nulle
|
|
- Servir derrière un reverse proxy avec HTTPS (Traefik, Caddy, Nginx Proxy Manager)
|
|
- Pas d'authentification native → placer derrière Authelia si exposition publique
|
|
- Fichier de configuration en read-only sur le volume
|
|
- Idéal pour les **réseaux familiaux** non exposés
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Démo officielle](https://homer-demo.netlify.app)
|
|
- [Documentation](https://github.com/bastienwirtz/homer/blob/main/docs/configuration.md)
|
|
- [Exemples de config](https://github.com/bastienwirtz/homer/blob/main/docs/2.configuration.md)
|
|
- [GitHub](https://github.com/bastienwirtz/homer)
|
|
- [Conteneur Docker](https://hub.docker.com/r/b4bz/homer)
|
|
|
|
## 🔗 Pages Liées
|
|
|
|
- [[cat-dashboard]]
|
|
- [[app-glance]]
|
|
- [[app-dashy]]
|
|
- [[app-homepage]]
|
|
- [[app-traefik]]
|
|
- [[securisation-home-lab]]
|
|
- [[recettes-docker-compose]]
|