Matrix + Element

  • 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)

  1. ✅ Créé ~/dev/matrix/conduit/docker-compose.yml (première version — voir Erreurs)
  2. ✅ docker compose up -d → ❌ boucle de panic (101) : l’image archivée matrixconduit/matrix-conduit exige CONDUIT_CONFIG (fichier TOML)
  3. ✅ Correctif 1 — image remplacée par girlbossceo/conduwuit:latest ; pull (168 Mo) OK, conteneur Up 4 seconds, port mappé
  4. ❌ curl vide — conduwuit 0.5 écoute sur 127.0.0.1/::1 dans le conteneur → port publié sans sortie
  5. ⏳ Correctif 2 — ajout de CONDUIT_ADDRESS: "0.0.0.0", recréé ; vérification curl _matrix/client/versions en attente

Phase 2 — Element-web (Docker)

  • Créer ~/dev/matrix/element/config.json pointant vers http://localhost:6167 (server name localhost)
  • docker run -d --name element ... vectorim/element-web:latest
  • Vérifier : curl -s -I http://localhost:8082 ré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:latest est le Conduit archivé / en fin de vie. Ses derniers builds ont supprimé l’entrypoint à variables d’env et plantent avec The CONDUIT_CONFIG env var needs to be set. Example: /etc/conduit.toml — ils exigent un fichier de config TOML, pas des variables d’env CONDUIT_*. ✅ Correctif : basculer vers le fork maintenu conduwuit (girlbossceo/conduwuit:latest) — même style de config par variables CONDUIT_*, 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/::1 dans le conteneur → le mapping de port 6167:6167 transmet vers la carte réseau du conteneur où rien n’écoute → curl ne renvoie rien alors que le conteneur est Up. 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 : ajouter CONDUIT_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 -p NAT, 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ÉtatPriorité suivante
Homeserver Conduit :6167⏳ recréé avec bind 0.0.0.0vérifier curl /_matrix/client/versions → JSON
Element-web :8082⏳ en attentelancer le conteneur
Compte + premier salon⏳ en attenteinscription avec token
Persistance (commande de restart)⏳ en attentenoter dans Local Services

Tableau credentials / config

ÉlémentValeurNotes
URL homeserverhttp://localhost:6167API client-server
Server name (IDs utilisateur)localhostp.ex. @bob:localhost
URL Elementhttp://localhost:8082
Token d’inscriptionchangeme-register-token⚠️ à changer — c’est la seule clé d’accès au serveur
Compte adminnon définivoir Travaux futurs
Volume de données~/dev/matrix/conduit/conduit-datasurvit 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

  1. Conduit est le choix léger pour un homeserver Matrix local uniquement : un conteneur, SQLite, pas de Postgres/Redis.
  2. 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.
  3. Element-web lit sa config homeserver dans /app/config.json monté en lecture seule — aucun rebuild nécessaire pour le pointer vers un serveur local.
  4. ⚠️ Le tag latest d’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.
  5. 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.
  6. 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.