- Projet : Serveur Matrix local (Conduit) + client Element-web
- Date de début : 2026-09-19
- Statut : En cours — Phase 1 reconfigurée (fix bind), vérification en attente
- Machine : Fedora 44, Docker disponible (PeerTube tourne déjà via
~/peertube)
Setup & contraintes
- Je veux un setup Matrix entièrement local : mon propre homeserver + mon propre client Element, sans serveur tiers.
- J’ai choisi Conduit plutôt que Synapse : binaire Rust unique avec SQLite, bien plus léger que Synapse (Python + PostgreSQL + Redis). Mon disque est serré en ce moment, donc le léger gagne.
- 🔒 Limitation sandbox : l’agent tourne dans le sandbox Obsidian et ne peut pas lancer Docker ni écrire dans
~/dev— je lance moi-même toutes les commandes dans mon terminal et je colle la sortie dans Matrix Setup Commands Results. - La fédération est désactivée (local uniquement) : pas de port 8448, pas de DNS, pas de TLS nécessaire.
Étapes chronologiques
Phase 1 — Homeserver Conduit (Docker)
- ✅ Créé
~/dev/matrix/conduit/docker-compose.yml(première version — voir Erreurs) - ✅
docker compose up -d→ ❌ boucle de panic (101) : l’image archivéematrixconduit/matrix-conduitexigeCONDUIT_CONFIG(fichier TOML) - ✅ Correctif 1 — image remplacée par
girlbossceo/conduwuit:latest; pull (168 Mo) OK, conteneurUp 4 seconds, port mappé - ❌
curlvide — conduwuit 0.5 écoute sur127.0.0.1/::1dans le conteneur → port publié sans sortie - ⏳ Correctif 2 — ajout de
CONDUIT_ADDRESS: "0.0.0.0", recréé ; vérificationcurl _matrix/client/versionsen attente
Phase 2 — Element-web (Docker)
- Créer
~/dev/matrix/element/config.jsonpointant vershttp://localhost:6167(server namelocalhost) -
docker run -d --name element ... vectorim/element-web:latest - Vérifier :
curl -s -I http://localhost:8082répond 200/301, la page s’affiche dans le navigateur - Coller la sortie dans le fichier de résultats
Phase 3 — Premier compte + premier chat
- Ouvrir
http://localhost:8082, cliquer Créer un compte (username p.ex.bob, n’importe quel mot de passe) - Saisir le token d’inscription quand demandé (voir tableau des credentials)
- Se connecter, créer un salon, envoyer un message de test
Erreurs
- ❌ Mauvais choix d’image :
matrixconduit/matrix-conduit:latestest le Conduit archivé / en fin de vie. Ses derniers builds ont supprimé l’entrypoint à variables d’env et plantent avecThe CONDUIT_CONFIG env var needs to be set. Example: /etc/conduit.toml— ils exigent un fichier de config TOML, pas des variables d’envCONDUIT_*. ✅ Correctif : basculer vers le fork maintenu conduwuit (girlbossceo/conduwuit:latest) — même style de config par variablesCONDUIT_*, même profil Rust léger, releases actives. Le volume de données n’est pas touché. - ❌ Adresse d’écoute manquante : conduwuit 0.5 écoute par défaut sur
127.0.0.1/::1dans le conteneur → le mapping de port6167:6167transmet vers la carte réseau du conteneur où rien n’écoute →curlne renvoie rien alors que le conteneur estUp. Le log le signalait clairement (« change this to 0.0.0.0 … If this is expected, you can ignore » — pas attendu avec mapping NAT). ✅ Correctif : ajouterCONDUIT_ADDRESS: "0.0.0.0"dans l’environnement du compose et recréer.
Constats root-cause
- conduwuit écoute sur loopback par défaut (
127.0.0.1/::1) — pensé pour des setups derrière reverse proxy. Dans Docker avec mapping-pNAT, le port publié aboutit à une impasse ;CONDUIT_ADDRESS: "0.0.0.0"est obligatoire. Le check de config log une ERROR qui l’explique. - conduwuit 0.5 utilise RocksDB, pas SQLite —
Created new RocksDB database, aucune config requise.
Tableau de statut
| Composant | État | Priorité suivante |
|---|---|---|
| Homeserver Conduit :6167 | ⏳ recréé avec bind 0.0.0.0 | vérifier curl /_matrix/client/versions → JSON |
| Element-web :8082 | ⏳ en attente | lancer le conteneur |
| Compte + premier salon | ⏳ en attente | inscription avec token |
| Persistance (commande de restart) | ⏳ en attente | noter dans Local Services |
Tableau credentials / config
| Élément | Valeur | Notes |
|---|---|---|
| URL homeserver | http://localhost:6167 | API client-server |
| Server name (IDs utilisateur) | localhost | p.ex. @bob:localhost |
| URL Element | http://localhost:8082 | |
| Token d’inscription | changeme-register-token | ⚠️ à changer — c’est la seule clé d’accès au serveur |
| Compte admin | non défini | voir Travaux futurs |
| Volume de données | ~/dev/matrix/conduit/conduit-data | survit aux redémarrages des conteneurs |
Bloc config réutilisable
Le docker-compose.yml et le config.json complets sont dans Matrix + Element - Config + Details. Décision clé : CONDUIT_ALLOW_FEDERATION: "false" → local uniquement, pas de TLS/DNS nécessaire.
Dernière vérification
docker logs conduit --tail 20 (2026-09-19 11:27, avant Correctif 2) :
2026-09-19T11:27:27.194198Z ERROR conduwuit_core::config::check: You are detected using Docker with a loopback/localhost listening address of 127.0.0.1:6167. … Please change this to "0.0.0.0". If this is expected, you can ignore.
2026-09-19T11:27:27.194309Z ERROR conduwuit_core::config::check: You are detected using Docker with a loopback/localhost listening address of [::1]:6167. …
2026-09-19T11:27:27.194587Z INFO conduwuit::server: 0.5.0 (4e5b87d) server_name=localhost database_path="/var/lib/conduit" log_levels=info
2026-09-19T11:27:27.352224Z INFO main:start:open: conduwuit_database::engine::open: Opened database. columns=88 sequence=0 time=113.82178ms
2026-09-19T11:27:27.373329Z WARN main:start: conduwuit_service::migrations: Created new RocksDB database with version 17
2026-09-19T11:27:27.376134Z INFO conduwuit_router::serve::plain: Listening on [127.0.0.1:6167, [::1]:6167]
→ curl -s http://localhost:6167/_matrix/client/versions a renvoyé vide (bind loopback + mapping NAT).
Travaux futurs / optionnel
- Définir un vrai compte admin via
@admin:localhost+ token d’inscription, puis modérer les salons - Réactiver la fédération plus tard (nécessite un server name public + reverse proxy TLS)
- Element Desktop (client Electron) pour une fenêtre native
- Bridge vers RocketChat/Nextcloud si je veux un jour l’interop chat
Leçons apprises
- Conduit est le choix léger pour un homeserver Matrix local uniquement : un conteneur, SQLite, pas de Postgres/Redis.
- Local uniquement = pas de port de fédération (8448), pas de TLS, pas de domaine — la moitié « difficile » du self-hosting Matrix disparaît complètement.
- Element-web lit sa config homeserver dans
/app/config.jsonmonté en lecture seule — aucun rebuild nécessaire pour le pointer vers un serveur local. - ⚠️ Le tag
latestd’un projet archivé est un piège — il est figé à jamais et peut embarquer un modèle de config différent des docs que tout le monde copie. Vérifier l’état de maintenance avant de faire confiance à une image. - Exit code 101 dans un conteneur Rust = panic au démarrage → toujours
docker logs <conteneur>avant de toucher la config ; le message dit exactement ce qui manque. - conduwuit 0.5 écoute sur loopback par défaut — sous Docker il faut poser
CONDUIT_ADDRESS: "0.0.0.0"sinon le port publié mène à une impasse. Il est aussi passé à RocksDB (et non SQLite) pour la base — créée automatiquement, plus lourde mais rien à configurer.