| Projet | Rocket.Chat auto-hébergé — chat d’équipe (local) |
| Date | 2026-09-19 (en marche, vérifié) |
| Statut | ✅ EN MARCHE — HTTP 200 OK, Mongo healthy — création admin en attente |
1. Contexte & contraintes
- Machine : Fedora 44 (migrée de Windows le 2026-09-18), OpenClaw/opencode dans la sandbox Flatpak d’Obsidian.
- Contrainte : la sandbox ne peut pas lancer Docker ni exposer de ports → je tape les commandes sur le terminal hôte et je colle la sortie dans
RocketChat Setup Results.mdpour interprétation. - Objectif : Rocket.Chat 8.x accessible sur
http://localhost:3000, MongoDB en réplica set, NATS comme bus interne.
2. Architecture choisie
Dépôt officiel rocketchat-compose (https://github.com/RocketChat/rocketchat-compose.git), avec 3 fichiers compose (monitoring/Traefik volontairement écartés pour du local) :
compose.database.yml → MongoDB 8.2 (mongodb-community-server ubi8), replSet rs0
compose.yml → Rocket.Chat 8.0.1 (registry.rocket.chat/rocketchat/rocket.chat)
compose.nats.yml → NATS 2.11-alpine (bus interne) + nats-exporter
3. Étapes chronologiques
Phase 1 — Clone & configuration (fait le 2026-09-07, d’après bash_history + fichiers)
sudo snap install rocketchat-desktop # client desktop (Snap)
git clone --depth 1 https://github.com/RocketChat/rocketchat-compose.git
cd ~/rocketchat-compose
cp .env.example .env
nano .env
Valeurs .env importantes (profil localhost) :
DOMAIN=localhost
ROOT_URL=http://localhost
RELEASE=8.0.1
LETSENCRYPT_ENABLED=false
TRAEFIK_PROTOCOL=http
MONGODB_BIND_IP=127.0.0.1
MONGODB_PORT_NUMBER=27017
NATS_BIND_IP=127.0.0.1
NATS_PORT_NUMBER=4222
REG_TOKEN=
Phase 2 — Démarrage de la stack (en cours)
# 1. S'assurer que Docker tourne
sudo systemctl start docker
# 2. Lancer la stack (3 fichiers)
cd ~/rocketchat-compose
sudo docker compose -f compose.database.yml -f compose.yml -f compose.nats.yml up -d
# 3. Vérifier
sudo docker compose -f compose.database.yml -f compose.yml -f compose.nats.yml ps
Résultat attendu : Rocket.Chat sur http://localhost:3000 (écran de première création du compte admin).
Résultat Phase 2 — 2026-09-19 ✅
docker compose up -d → [+] up 45/45, aucune erreur. Les 6 conteneurs sont créés et tournent :
mongodb-1— Up (health: starting),127.0.0.1:27017->27017mongodb-init-container-1— Up (initialise le replSetrs0)rocketchat-1— Up,0.0.0.0:3000->3000,9458->9458nats-1— Up,127.0.0.1:4222->4222mongodb-exporter-1,nats-exporter-1— Up (métriques)
Pas de conflit de port : 27017 était libre (pas de mongod système) — l’erreur anticipée n°1 ne s’est pas produite.
4. Erreurs
| ❌ Hypothèse fausse | ✅ Correctif |
|---|---|
| (à remplir au fil de l’eau) |
5. Constats racines
ROOT_URL=http://localhostsans Traefik : la stack officielle suppose Traefik sur le port 80. Sans Traefik, Rocket.Chat est servi sur :3000 → si l’UI charge mais que le websocket ne se connecte pas, mettreROOT_URL=http://localhost:3000dans.envet recréer le conteneur.- Conflit port 27017 : la stack bind MongoDB sur
127.0.0.1:27017. Si lemongodsystème (époque freeCodeCamp) tourne, il se battra pour le même port → l’arrêter d’abord (sudo systemctl stop mongod). Ne s’est pas produit — 27017 était libre. MAIL_URLnon définie →UnHandledPromiseRejectionbénin dans les logs quand Rocket.Chat tente d’envoyer les emails de vérification/inscription. Pas de SMTP = pas d’email ; sans impact en local. Pour le faire taire : mettreMAIL_URL=smtp://...(ou laisser tel quel).- Poll confirmation Cloud
Too Many Requests→ normal pour une instance locale sansREG_TOKEN; le workspace interroge Rocket.Chat Cloud et se fait limiter. Sans impact ; à ignorer en local.
6. Tableau de statut
| Composant | État | Notes |
|---|---|---|
| App Rocket.Chat (:3000) | ✅ UP | HTTP 200 OK confirmé (curl) |
| MongoDB (:27017) | ✅ healthy | replSet rs0 initialisé par le helper one-shot (sorti) |
| NATS (:4222) | ✅ tourne | bind 127.0.0.1 |
| Client desktop (snap) | ❌ désinstallé (2026-09-19) | retiré via sudo snap remove rocketchat-desktop — serveur intact |
7. Tableau identifiants / config
| Élément | Valeur | Notes |
|---|---|---|
| UI web | http://localhost:3000 | création du premier admin au 1er run |
| ROOT_URL | http://localhost (→ peut-être :3000, voir constat) | changer → recréer le conteneur |
| MONGO_URL (dans l’app) | mongodb://mongodb:27017/rocketchat?replicaSet=rs0 | interne |
| MongoDB replSet | rs0 | défaut du compose ; la fiche service dit « rs01 » → incohérence, on est en rs0 |
| Volume données Mongo | mongodb_data (volume docker) | |
| NATS URL | monolith+nats://nats:4222 | interne |
| Grafana (seulement si monitoring ajouté) | admin / rc-admin (:5050) | non démarré |
8. Bloc de config réutilisable
Commandes start / stop :
# start
cd ~/rocketchat-compose
sudo docker compose -f compose.database.yml -f compose.yml -f compose.nats.yml up -d
# stop
sudo docker compose -f compose.database.yml -f compose.yml -f compose.nats.yml down
# reset complet (perd les données)
sudo docker compose -f compose.database.yml -f compose.yml -f compose.nats.yml down -v
9. Dernier snapshot de vérification
2026-09-19, 07:29 GMT — curl http://localhost:3000:
HTTP/1.1 200 OK
X-Instance-ID: 5000b11e-2851-44d4-bdd0-e129c4a21401
Access-Control-Allow-Origin: *
Content-Type: text/html; charset=utf-8
docker compose ps (7 min après start) : les 5 services restants Up 7 minutes ; mongodb-1 healthy ; conteneur init sorti proprement. Logs complets dans RocketChat Setup Results.md.
10. Travail optionnel / à venir
- Ouvrir http://localhost:3000, créer l’admin, envoyer un message test
- Si le websocket échoue → mettre ROOT_URL=http://localhost:3000, redémarrer
- Ajouter le monitoring (compose.monitoring.yml : Prometheus :9000, Grafana :5050)
- Ajouter Traefik + HTTPS si exposition au-delà de localhost
- Mettre à jour
Local Services.mdavec une ligne Rocket.Chat - Corriger la fiche LinkedIn : replset = rs0, pas rs01
Leçons apprises
- La stack compose officielle a 5+ fichiers ; pour du 100 % local il ne faut que « database + app + nats » — pas de Traefik.
- Le replset Mongo 8 est initialisé automatiquement par un conteneur helper (
mongodb-init-container) — plus besoin ders.initiate()manuel (le vieux hacksedsur/etc/mongod.confest obsolète avec les images officielles). - Le port 27017 est partagé entre le Mongo du compose et tout
mongodsystème — toujours vérifier avantup -d. ROOT_URLdoit correspondre au vrai port d’écoute quand on zappe Traefik.