Rocket.Chat

ProjetRocket.Chat auto-hébergé — chat d’équipe (local)
Date2026-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.md pour 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->27017
  • mongodb-init-container-1 — Up (initialise le replSet rs0)
  • rocketchat-1 — Up, 0.0.0.0:3000->3000, 9458->9458
  • nats-1 — Up, 127.0.0.1:4222->4222
  • mongodb-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://localhost sans 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, mettre ROOT_URL=http://localhost:3000 dans .env et recréer le conteneur.
  • Conflit port 27017 : la stack bind MongoDB sur 127.0.0.1:27017. Si le mongod systè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_URL non définie → UnHandledPromiseRejection bé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 : mettre MAIL_URL=smtp://... (ou laisser tel quel).
  • Poll confirmation Cloud Too Many Requests → normal pour une instance locale sans REG_TOKEN ; le workspace interroge Rocket.Chat Cloud et se fait limiter. Sans impact ; à ignorer en local.

6. Tableau de statut

ComposantÉtatNotes
App Rocket.Chat (:3000)✅ UPHTTP 200 OK confirmé (curl)
MongoDB (:27017)✅ healthyreplSet rs0 initialisé par le helper one-shot (sorti)
NATS (:4222)✅ tournebind 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émentValeurNotes
UI webhttp://localhost:3000création du premier admin au 1er run
ROOT_URLhttp://localhost (→ peut-être :3000, voir constat)changer → recréer le conteneur
MONGO_URL (dans l’app)mongodb://mongodb:27017/rocketchat?replicaSet=rs0interne
MongoDB replSetrs0défaut du compose ; la fiche service dit « rs01 » → incohérence, on est en rs0
Volume données Mongomongodb_data (volume docker)
NATS URLmonolith+nats://nats:4222interne
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.md avec une ligne Rocket.Chat
  • Corriger la fiche LinkedIn : replset = rs0, pas rs01

Leçons apprises

  1. La stack compose officielle a 5+ fichiers ; pour du 100 % local il ne faut que « database + app + nats » — pas de Traefik.
  2. Le replset Mongo 8 est initialisé automatiquement par un conteneur helper (mongodb-init-container) — plus besoin de rs.initiate() manuel (le vieux hack sed sur /etc/mongod.conf est obsolète avec les images officielles).
  3. Le port 27017 est partagé entre le Mongo du compose et tout mongod système — toujours vérifier avant up -d.
  4. ROOT_URL doit correspondre au vrai port d’écoute quand on zappe Traefik.