---
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]]
