Souverain

Comme vous avez pu le lire sur ce site, je suis à la recherche d’un outil d’édition collaborative qui coche deux cases souvent incompatibles dans le monde réel : usage moderne (édition temps réel, partage, invitations) et cohérence “souveraineté” (auto-hébergement, briques libres, logique de commun numérique). Dans l’écosystème français, La Suite porte précisément cette ambition : une collection de communs numériques conçus pour le secteur public et réutilisables par tous.

Avant de toucher à mon serveur, j’ai commencé “proprement” : tester l’outil sur une instance de démonstration, histoire de valider l’UX et de vérifier que l’éditeur répondait à mon besoin. Puis je suis passé au vrai sujet : l’installation sur YunoHost. Pour cela il existe un paquet disponible depuis le catalogue de Yunohost. J’en profite également pour remercier les créateurs de ce paquet : Marie PJ⏚ et Florent.

Comprendre l’architecture (ce que le paquet implique)

Le paquet YunoHost de La Suite – Docs n’est pas une installation “monobloc”. Deux dépendances structurantes sont à connaître :

1. L’authentification via DEX
   La suite – Docs fonctionne avec DEX, disponible depuis le catalogue YunoHost.
2. Le stockage de fichiers via un backend S3
   Le paquet indique qu’il faut un stockage S3 avant d’installer La suite -Docs, typiquement MinIO (ou Garage d’après « le message d’informations importantes avant l’installation » mais ne surtout pas faire ça !!!!).
   

En clair : pour que La suite – Docs fonctionne, il faut Dex (identité) + MinIO (stockage S3) + La suite Docs (application).

Pré-requis pratiques côté YunoHost

Point très concret, mais déterminant : prévoyez un domaine ou sous-domaine par brique.

Dans mon cas, cela signifie :

• un sous-domaine pour MinIO,
• un sous-domaine pour La suite – Docs.

Mon premier essai : Dex + MinIO + La suite – Docs… puis un mur

Étape 1 : Installation de Dex

Dex est un service d’identité qui utilise OpenID Connect pour piloter l’authentification d’autres applications. Ce package YunoHost installera Dex et configurera un fournisseur canonique OpenID Connect pour votre instance YunoHost, basé sur la base d’utilisateurs LDAP, qui pourra ensuite être utilisé comme serveur d’authentification pour d’autres applications YunoHost.

Étape 2 : Installation de MinIO

Je l’ai installé car il va servir, de ce que j’ai compris, de backend pour les fichiers / objets manipulés par La suite – Docs.

Étape 3 : Installation de La Suite – Docs

Le formulaire d’installation de Docs vous force de facto à pointer vers un Dex déjà présent et un backend S3 déjà présent (les chemins sont simples, pré-remplis, mais il faut que les apps existent). Cette logique correspond aux prérequis indiqués côté paquet.

Résultat : installation OK, connexion OK, création d’un document OK…
…mais impossible d’éditer : message d’erreur côté interface :

« Une erreur inattendue s’est produite, veuillez réessayer. »

J’ai cherché, sans succès. Peu de retours, peu de pas-à-pas, peu de “symptômes ↔ causes” documentés, bref, j’étais bien seul, mais je n’ai pas lâché (et pourtant, j’en avais envie …)

Deuxième essai : remplacer MinIO par Garage… et j’étais très frustré du résultat

En lisant les prérequis et les discussions autour du paquet, je pensais que Garage pourrait apparaît comme une alternative à MinIO.

Je me suis donc dit : “si MinIO est peut-être le point faible, changeons de backend”.

• Installation de Garage,
• Réinstallation de La suite – Docs en pointant vers Garage au lieu de MinIO.

Autre résultat, cette fois, au moment de l’installation de La suite – Docs, j’ai un message d’erreur et impossible de continuer l’installation.

L’erreur qui m’a fait perdre le plus de temps : désinstaller sans supprimer les données

À force d’installer/désinstaller pour isoler la cause, j’ai fait l’erreur classique :
désinstaller une app sans cocher l’option du type :

« Supprimer le répertoire de données associé à l’application… »

Conséquence : je tournais en rond. Je voulais de nouveau installer MinIO, mais le service ne démarrait plus, et La suite – Docs devenait impossible à réinstaller proprement (puisque l’installeur, j’imagine, attendait un backend S3 fonctionnel).

Dès que j’ai compris que je traînais un état résiduel (données/config), j’ai refait un cycle propre :

• désinstallation, de tout !
• suppression explicite des données (pensez-bien à cocher la case hein, pas comme moi)
• réinstallation Dex → MinIO → La suite – Docs.

Et là, double effet :

1. Docs redevenait installable et utilisable,
2. et, sans que je puisse identifier précisément le “déclic”, l’édition de document s’est mise à fonctionner.

Je préfère être transparent : je n’ai pas la cause racine. Mais j’ai une certitude opérationnelle : les résidus de données rendent le diagnostic presque impossible et peuvent bloquer les services de manière non évidente.

Check-list “anti-frustration” pour tester La suite – Docs sans stress

1) Préparez les domaines / sous-domaines

• 1 pour MinIO
• 1 pour La suite – Docs

2) Installez dans le bon ordre

1. Dex
2. MinIO
3. La Suite – Docs

3) Pour un test simple : mettez l’accès en “Visiteurs”

Dans mon cas, ça a évité d’ajouter une couche de restrictions ou d’incompréhension technique pendant la phase de test.

4) À l’installation de Docs : sélectionnez bien Dex + MinIO

Le paquet attend un fournisseur (Dex) et un stockage S3 (MinIO) déjà en place, il faut juste les sélectionner, depuis un menu déroulant !

5) Si vous devez “repartir de zéro”

Quand vous désinstallez pour réinstaller :

• supprimez aussi les données en n’oubliant pas de cocher la case comme indiqué en haut 😉
• sinon vous risquez de conserver exactement le problème que vous essayez d’éliminer (comme c’était mon cas …)

Et maintenant : j’attends Meet / Visio

Modification du 22 décembre 2025 : j’ai réussi à installer La suite Visio et je vous invite à lire mon article qui en parle.
La promesse logique, après La suite – Docs, c’est la brique visioconférence. Côté YunoHost, un paquet Meet existe déjà au niveau dépôt, décrit comme une visio “Powered by LiveKit”, j’ai essayé de l’installer, mais cela n’a pas fonctionné. De ce que j’ai pu lire via un dépôt sur Github : l’équipe devrait bientôt reprendre le travail pour terminer le paquet (chouette !!!!). Si vous souhaitez en savoir plus, j’ai cet article à vous recommander.

C’est typiquement le genre de brique qui peut remplacer des usages Teams / Zoom.