109 lines
4.3 KiB
Markdown
109 lines
4.3 KiB
Markdown
---
|
|
title: miniboard
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, dashboard, minimal, docker, vieux-materiel]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Dashboard, https://github.com/erming/miniboard]
|
|
---
|
|
|
|
# 📊 miniboard
|
|
|
|
> Dashboard **ultra-léger** qui tient en quelques Ko et tourne sur le plus modeste des matériels : une page d'accueil Docker + services, sans superflu.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Attribut | Valeur |
|
|
|----------|--------|
|
|
| **Nom** | miniboard |
|
|
| **Slug** | miniboard |
|
|
| **Description** | Dashboard minimaliste : tuiles services + statut Docker, conçu pour vieux matériel |
|
|
| **Site officiel** | https://github.com/erming/miniboard |
|
|
| **Repository** | https://github.com/erming/miniboard |
|
|
| **Stars** | 240 ⭐ |
|
|
| **Licence** | MIT |
|
|
| **Langage principal** | Go (compilé, binaire unique) |
|
|
| **Catégorie** | Dashboard |
|
|
| **Tags** | [catalogue, dashboard, minimal, docker, vieux-materiel] |
|
|
|
|
## 📝 Description
|
|
|
|
miniboard est né d'un constat simple : Glance, Homepage et Dashy sont **trop lourds** quand on a un Raspberry Pi Zero, un vieux NUC, ou un routeur sous OpenWrt qui sert déjà 3 trucs. miniboard propose exactement l'inverse : **un binaire statique Go, quelques Mo de RAM, et une page HTML servie localement**.
|
|
|
|
Caractéristiques :
|
|
|
|
- **Binaire unique** : pas de runtime, pas de node_modules, pas de virtualenv. On télécharge, on lance, c'est tout.
|
|
- **Consommation mémoire** : < 20 Mo RSS en fonctionnement normal, là où Homepage monte à 100+ Mo.
|
|
- **Statut Docker** : interroge le socket Docker local (optionnel) pour afficher l'état des containers.
|
|
- **Tuiles services** : simples liens cliquables vers les URLs configurées.
|
|
- **Configuration** : un seul fichier TOML/YAML, pas d'UI d'admin (c'est voulu).
|
|
- **Thème** : dark/light, customisable via CSS.
|
|
|
|
Pour un homelab où le dashboard tourne à côté de 15 containers sur un Pi 4, c'est l'option **zéro compromis** : on garde un point d'entrée unique sans plomber la machine.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Via Docker (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
miniboard:
|
|
image: ghcr.io/erming/miniboard:latest
|
|
container_name: miniboard
|
|
restart: unless-stopped
|
|
environment:
|
|
- MINIBOARD_PORT=8080
|
|
- MINIBOARD_CONFIG=/config/config.yaml
|
|
volumes:
|
|
- ./config.yaml:/config/config.yaml:ro
|
|
- /var/run/docker.sock:/var/run/docker.sock:ro
|
|
ports:
|
|
- "8080:8080"
|
|
```
|
|
|
|
> ⚠️ Le montage du socket Docker est optionnel (permet l'affichage du statut des containers), à retirer si l'on n'en a pas besoin.
|
|
|
|
### Installation manuelle
|
|
|
|
Télécharger le binaire de la release, créer un fichier `config.yaml`, lancer `./miniboard`. Idéal sur du matériel où Docker n'est même pas installé.
|
|
|
|
## ⚙️ Configuration
|
|
|
|
- **Sections `services`** : liste de liens (label, URL, icône, groupe).
|
|
- **Section `docker`** : si activée, le binaire interroge `/var/run/docker.sock` pour lister les containers et leur état.
|
|
- **Pas d'authentification** : à mettre derrière un reverse proxy (Traefik) avec auth si exposé.
|
|
- **Thème** : variables CSS en haut du fichier YAML.
|
|
- **Refresh** : intervalle de polling Docker configurable (par défaut 30s).
|
|
|
|
## 🔗 Alternatives
|
|
|
|
- **Homer** — autre dashboard statique léger, plus de fonctionnalités (météo, IP).
|
|
- **TraLa** — encore plus minimaliste, sans statut Docker.
|
|
- **Dashdot** — focus stats système (CPU/RAM/disk/réseau), pas de services.
|
|
- **Heimdall** — plus complet, mais nettement plus lourd.
|
|
|
|
## 🔒 Sécurité
|
|
|
|
- **Socket Docker en lecture seule** : limiter les permissions (montage `:ro`, capability `DAC_READ_SEARCH`).
|
|
- **Pas d'auth native** : reverse proxy + Authelia/Authentik pour l'accès distant.
|
|
- **HTTPS** : obligatoire via Traefik/Caddy dès qu'on sort du LAN.
|
|
- **Surface d'attaque** : quasi-nulle (binaire statique sans dépendance, peu d'API), un des avantages clés de l'approche minimaliste.
|
|
|
|
## 📚 Ressources
|
|
|
|
- Repository : https://github.com/erming/miniboard
|
|
- Releases : https://github.com/erming/miniboard/releases
|
|
|
|
## 🔗 Pages Liées
|
|
|
|
- [[cat-dashboard]]
|
|
- [[app-homer]] — cousin statique
|
|
- [[app-trala]] — encore plus minimal
|
|
- [[app-traefik]] — reverse proxy
|
|
- [[app-authelia]] — auth légère
|
|
- [[recettes-docker-compose]]
|
|
- [[securisation-home-lab]]
|