Hermes Dashboard (dashu) — espace de travail auto-hébergé
- Type
- Projet personnel
- Date
- novembre 2026
- Statut
- v1 en service, v2 en cours
- Technologies
- Rust, htmx, SQLite, ffmpeg, Proxmox, LXC, Debian, systemd, Cloudflare, Tailscale, OpenID Connect, GitHub Actions, Lighthouse, Claude Code
- Compétences
- B1.1 Gérer le patrimoine informatique ; B1.4 Travailler en mode projet ; B1.5 Mettre à disposition des utilisateurs un service informatique ; B1.6 Organiser son développement professionnel
Contexte
Entre le BTS (emploi du temps sur Pronote Campus), l'alternance chez 1Life et le perso, mes notes, mes tâches et mes agendas étaient éparpillés entre plusieurs applications. Je voulais un seul endroit, à moi et hébergé chez moi : une sorte de Microsoft 365 personnel, fait sur mesure plutôt qu'un tableau de bord tout fait.
J'en ai aussi fait un exercice de gestion de projet : écrire un vrai cahier des charges, avec des critères d'acceptation vérifiables, le faire réaliser par une IA (Claude), et garder la main sur les choix, le déploiement et la validation.
Depuis le 12 novembre 2026, l'application s'affiche sous le nom Hermes Dashboard, comme mes autres projets ; dashu reste son nom de code (dépôt, programme, commandes).
Objectifs
- Une seule porte d'entrée : identifiant et mot de passe, ou compte Google. Inscription fermée : seules les adresses autorisées entrent.
- Des espaces, Perso, École et Taff au départ : chaque note, tâche, fichier ou agenda appartient à un espace, et Perso réunit le contenu de tous les espaces.
- Des notes Markdown avec recherche, les tâches du jour, et l'emploi du temps importé de Pronote Campus.
- En v2, un endroit pour mes fichiers (cours, scans, photos d'iPhone), rangés en dossiers, et des conversions qui ne mettent jamais le serveur en danger.
- Rapide (score Lighthouse mobile d'au moins 95) et utilisable sur téléphone comme une application.
- Hébergé sur mon homelab, joignable de partout sans ouvrir de port sur la box.
- Facile à exploiter : sauvegarde chaque nuit, vérifiée par une vraie restauration, et mise à jour en une commande avec retour arrière automatique.
Mise en œuvre
Le cahier des charges. J'ai rédigé la spécification : périmètre de la v1 et ce qui en est exclu, technologies, modèle de données, exigences de performance et de sécurité, déploiement, et 14 critères d'acceptation. Un fichier de suivi indique, pour chaque critère, s'il est vérifié, où et comment, et liste les écarts au cahier des charges avec leur justification. Chaque évolution suivante (fichiers, espaces et outils, barre de commandes, dossiers) a eu sa propre section, avec ses critères, écrite avant le code.
L'application. Un seul programme écrit en Rust, qui fabrique les pages côté serveur ; la bibliothèque htmx rend la navigation fluide, sans recharger la page. Les données sont dans une base SQLite, avec une recherche plein texte. Les notes s'éditent mises en forme, comme dans Notion (un menu « / » insère titres, listes, tableaux ou images), mais restent enregistrées en Markdown. L'emploi du temps est synchronisé toutes les heures depuis le lien iCal de Pronote Campus. Une barre de commandes, ouverte par « / », permet de tout faire au clavier. Une API JSON, protégée par un jeton, permet à Hermès, mon agent IA, de gérer mes tâches et mes notes, et de lire mon agenda.
La sécurité.
- Mots de passe hachés avec Argon2id, et 5 tentatives de connexion par minute au plus pour une même adresse IP.
- Connexion Google par OpenID Connect, avec un client OAuth que j'ai créé dans la Google Cloud Console. Une adresse absente de la liste autorisée est refusée.
- Politique de sécurité du contenu (CSP) stricte : aucun script ni style en ligne. Le contenu des notes est nettoyé pour empêcher l'injection de script.
- Le service tourne sous un utilisateur système sans droits, n'écoute que sur la machine elle-même (127.0.0.1) et voit le système de fichiers en lecture seule (durcissement systemd).
- Hermès n'a qu'un accès SSH limité à six actions (état, journaux, redémarrage, mise à jour, suivi de la mise à jour, sauvegarde), imposées par une commande forcée.
La v2 : les fichiers et les dossiers.
- J'ai vidé le second disque du serveur (465 Go, une ancienne installation de Proxmox) et je l'ai déclaré comme stockage LVM-thin dans Proxmox. Deux volumes y sont montés dans le conteneur : 45 Go pour les fichiers, 5 Go pour les sauvegardes de la base, qui ne sont donc plus sur le même disque qu'elle. Un troisième volume, sur le premier disque cette fois, reçoit chaque nuit la copie des fichiers : chaque donnée existe sur deux disques. Cette copie est incrémentale (un fichier déjà sauvegardé n'est pas recopié, il est relié au précédent par un lien dur avec rsync), gardée 14 jours, et restaurer la base d'une nuit remet aussi les fichiers de cette nuit-là.
- Un fichier part en morceaux de 50 Mo, car l'offre gratuite de Cloudflare refuse les requêtes de plus de 100 Mo. Sur le disque, il porte un nom aléatoire, jamais celui choisi par l'utilisateur. Il n'est jamais exécuté dans la page : seuls les types sans code (images, vidéos, sons) s'affichent, le reste est servi en téléchargement, avec une CSP « sandbox ».
- Les conversions (photos HEIC d'iPhone, vidéos, sons, PDF, et documents Markdown avec pandoc et Typst) tournent dans un service à part : un autre utilisateur système, sans réseau, qui ne voit ni la base ni les fichiers rangés, limité à 1,5 Go de mémoire. Le service web, limité à 256 Mo, ne lance jamais d'outil lui-même.
- Des dossiers et sous-dossiers, trois niveaux au plus, rangent les fichiers et les notes. Ils n'existent que dans la base : rien ne bouge sur le disque, et un nom de dossier ne peut désigner aucun autre fichier. On range par une fenêtre qui montre tout l'arborescence, ou en glissant à la souris ; supprimer un dossier qui n'est pas vide passe par un avertissement.
- Les fichiers ont les mêmes tags que les notes, et une recherche sur le nom (index plein texte de SQLite, accents ignorés) dans le dossier ouvert et ses sous-dossiers. Un fichier se renomme depuis son aperçu ou la liste : seule la partie avant l'extension change, le type du fichier reste celui de l'envoi.
- Un fichier se partage par un lien valable 1 heure, 1 jour ou 7 jours, et révocable. Le lien contient 32 octets aléatoires ; la base n'en garde que l'empreinte SHA-256, donc la lire ne permet pas de reconstituer un lien. La page du lien ne montre que le nom et la taille, et télécharge le fichier ; expiré, révoqué ou inconnu, c'est la même page, et le nombre de requêtes par adresse IP est limité.
Le déploiement sur mon homelab.
- Un conteneur LXC Debian 13 sur Proxmox. dashu y est compilé sur place et lancé comme service systemd.
- Un tunnel Cloudflare : le conteneur ouvre une connexion sortante vers Cloudflare, qui publie app.dashu.dev en HTTPS. Aucun port n'est ouvert sur la box. J'ai confié la gestion DNS du domaine dashu.dev à Cloudflare.
- Tailscale : un second accès, par mon VPN, qui marche même si Cloudflare tombe.
- dashu.dev affiche une page publique qui présente le projet (GitHub Pages).
L'exploitation.
- Une sauvegarde à chaud de la base chaque nuit à 3 h 30 (minuterie systemd), vérifiée par SQLite et gardée 14 jours, puis la copie des fichiers sur l'autre disque.
- dashu-restore remet une sauvegarde en service : il met d'abord la base actuelle de côté, et revient en arrière tout seul si dashu ne redémarre pas.
- dashu-update récupère le code, recompile, sauvegarde la base, remplace le programme et vérifie que le service répond. Sinon, il remet la version précédente.
- À chaque modification, GitHub Actions vérifie le format et la qualité du code, lance les tests automatiques (247 aujourd'hui), rejoue le bac à sable systemd du serveur, teste le script de sauvegarde des fichiers et construit une image Docker de moins de 30 Mo.
Le suivi du projet. Après la v1, chaque évolution est passée par une pull request, testée avant d'être fusionnée : l'API pour Hermès, la vue d'ensemble de l'agenda dans Perso, une navigation sans écran noir, un sélecteur d'espace façon « Dynamic Island » avec changement d'espace par balayage, une barre de raccourcis sur téléphone, l'installation en application sur l'écran d'accueil de l'iPhone. Puis des espaces à la carte (jusqu'à huit), un dashboard modulaire, la v2 des fichiers, la barre de commandes qui remplace la palette Ctrl+K, le nouvel éditeur de notes et les dossiers.
Réalisé avec Claude Code. Mon rôle : définir le besoin, faire les choix et tester. Le déploiement et l'exploitation (Proxmox, Cloudflare, Tailscale, Google, sauvegarde et restauration), je les ai faits moi-même sur mon serveur, guidé pas à pas.
Code source : github.com/moreauremi/dashu · Présentation : dashu.dev
Captures d'écran
Captures de la v1, le 11 novembre 2026, sur une copie de dashu remplie de données de démonstration (faux cours, fausses notes). La dernière est la sortie réelle de la restauration sur mon serveur. Depuis, l'éditeur ne montre plus qu'une vue mise en forme, et la palette Ctrl+K est devenue la barre de commandes.






Résultats et tests
- Les 14 critères d'acceptation du cahier des charges sont vérifiés, la plupart sur le serveur réel.
- 96 tests automatiques à la fin de la v1, 247 aujourd'hui (connexion, isolation des données entre deux comptes, notes, lecture de l'agenda heure d'été comprise, API, injection de script, fichiers piégés, dossiers, liens de partage expirés ou révoqués), lancés par GitHub Actions à chaque pull request.
- Lighthouse mobile sur le serveur (v1), via Cloudflare, en 4G simulée : 99 pour le dashboard, 100 pour les notes, 100 pour l'agenda, 99 pour l'éditeur.
- À la fin de la v1, le service occupait 7,6 Mo de mémoire et répondait en 0,5 ms ; l'image Docker faisait 7 Mo.
- Connexion Google testée avec mon compte (le même que par mot de passe) et avec un compte non autorisé, qui est refusé.
- Restauration réelle le 11 novembre 2026 : une note créée après la sauvegarde disparaît à la restauration, puis revient quand on l'annule.
- Compression vérifiée sur le serveur, à travers le service isolé : une photo HEIC de 4032 × 3024 devient un JPEG de 2560 × 1920 (816 Ko → 391 Ko), un PDF passe de 626 Ko à 57 Ko, une vidéo 4K HDR de 10 s devient un MP4 1080p de 3,7 Mo au lieu de 54,8 Mo. Pendant une conversion, le service ne voit que l'interface réseau locale.
- Dossiers essayés sur le serveur le 15 novembre 2026, depuis mon iPhone et mon ordinateur.
- Hermes Dashboard me sert au quotidien depuis novembre 2026, sur ordinateur et sur iPhone.
Difficultés rencontrées
Le site injoignable depuis le Wi-Fi de la maison. app.dashu.dev marchait en 4G, mais pas chez moi. Le DNS de la box gardait en mémoire une ancienne réponse, « ce nom n'existe pas », d'avant le passage du domaine chez Cloudflare. Je l'ai vu en comparant les réponses du DNS de la box et de celui de Cloudflare (1.1.1.1). Sur Mac, nslookup interroge directement le serveur DNS, alors que le navigateur passe par le cache du système : dscacheutil m'a montré ce que voyait vraiment le navigateur. Solution : mes appareils utilisent les serveurs DNS imposés par Tailscale, plutôt que celui de la box.
Une mise à jour qui pouvait se tromper. En relisant le script de mise à jour, un défaut est apparu : si la compilation échouait, le code source était déjà à jour mais pas le programme en service, et la mise à jour suivante répondait « Déjà à jour » sans recompiler. Correction : la version réellement en service est notée à part, et la commande d'état signale tout écart.
Une sauvegarde jamais restaurée ne prouve rien. La sauvegarde tournait chaque nuit, mais rien ne montrait qu'on pouvait la remettre en place. J'ai fait l'exercice sur le serveur sans rien perdre : la base actuelle est mise de côté avant chaque restauration, et une note témoin prouve que les données viennent bien de la sauvegarde.
Le zoom sur iPhone. Ajoutée à l'écran d'accueil, l'application se laissait zoomer comme une page web, et iOS ignore la consigne standard depuis iOS 10. Solution : un manifeste d'application, et un blocage du pincement uniquement en mode application. Dans Safari, le zoom reste possible, pour l'accessibilité.
Une compression qui marchait partout, sauf sur le serveur. Le bouton « Compresser » échouait en production alors que tous les tests passaient. Deux causes, propres au bac à sable systemd du service, absent en local et dans les tests : RestrictSUIDSGID=yes refuse tout chmod qui pose le bit setgid, et chaque dossier déclaré en ReadWritePaths est un point de montage à part, si bien qu'un simple renommage d'un dossier à l'autre échoue (EXDEV). Correction : plus de bit setgid, et une copie suivie d'un effacement quand le renommage échoue. Pour que l'erreur ne revienne pas, la CI rejoue maintenant ce bac à sable.
Une mesure faussée. Le premier Lighthouse du dashboard donnait environ 94, sous la cible : les extensions de mon navigateur ajoutaient du travail au chargement de la page. Mesure refaite trois fois dans une fenêtre Invité, sans extension : médiane de 99.
Pistes d'amélioration
- Faire l'exercice de restauration avec un fichier sur le serveur : en supprimer un, puis le faire revenir avec la sauvegarde de la nuit.
- Surveiller le service avec Uptime Kuma, dans son propre conteneur (la procédure est écrite), pour être prévenu d'une panne.
- Finir la v2 : ouvrir les fichiers à l'API d'Hermès.
Compétences mises en œuvre
- B1.1 : gérer des sauvegardes (sauvegarde nocturne vérifiée, restauration réelle, sauvegardes croisées : la base sur le second disque, les fichiers sur le premier) ; mettre en place et vérifier les niveaux d'habilitation (adresses autorisées, jeton d'API, accès SSH d'Hermès limité à six actions, liens de partage temporaires et révocables) ; vérifier la continuité du service (deux accès, retour arrière automatique des mises à jour, adresse de contrôle /health).
- B1.4 : rédiger un cahier des charges avec des critères d'acceptation, découper le travail en pull requests, suivre l'avancement critère par critère et analyser les écarts au cahier des charges.
- B1.5 : réaliser les tests d'intégration et d'acceptation (tests automatiques, critères vérifiés sur le serveur, mesures Lighthouse), déployer le service (Proxmox, LXC, stockage LVM-thin et points de montage, systemd, service de conversion isolé, Cloudflare, Tailscale, DNS, OAuth Google) et documenter son installation et son exploitation.
- B1.6 : mettre en place mon environnement de travail personnel, avec mes cours, mes notes de révision et mon emploi du temps au même endroit, et m'en servir au quotidien.