Migrer Rocket.Chat vers Mattermost sur VPS

Ce qui change dans Rocket.Chat 9.0

Pourquoi Mattermost Community est une alternative solide

• LDAP et SAML inclus sans licence — Mattermost distribue l'authentification Active Directory et SAML dans son édition open source, sous licence MIT pour le serveur (Apache 2.0 pour les contributions), sans condition de plan payant.
• PostgreSQL natif — Mattermost s'appuie sur PostgreSQL, bien documenté, facile à sauvegarder avec pg_dump et plus courant que MongoDB dans les environnements Docker self-hosted.
• mmetl, un outil officiel de migration — l'outil mmetl de l'équipe Mattermost transforme un mongodump de Rocket.Chat en fichier d'import JSONL compatible avec mmctl import, incluant canaux, utilisateurs et messages.
• Empreinte mémoire plus basse — Mattermost peut démarrer avec 2 Go de RAM pour une équipe de moins de cinquante utilisateurs ; Rocket.Chat exige un replica set MongoDB qui consomme davantage à volume équivalent.
• Applications desktop et mobiles officielles — les clients iOS, Android, macOS et Windows pointent vers votre propre domaine dès l'installation.
• Historique complet, fichiers joints sans quota — aucune fenêtre glissante, aucune coupure à un volume de messages, tout est stocké sur votre disque ou votre bucket S3.

Prérequis chiffrés

Sauvegarder Rocket.Chat

1. 01

   Mettre Rocket.Chat en lecture seule

   Avant toute sauvegarde, prévenez vos utilisateurs et passez l'instance en mode maintenance. Dans l'administration Rocket.Chat, allez dans Administration → Généralités → Mode maintenance et activez le mode lecture seule. Cela évite que des messages soient écrits après le dump et perdus à la bascule.

   Alternativement, si vous ne disposez pas de ce mode, arrêtez simplement le conteneur Rocket.Chat :

   docker compose stop rocketchat

2. 02

   Exporter la base MongoDB avec mongodump

   mmetl attend un répertoire produit par mongodump, pas un fichier compressé. Lancez le dump depuis l'hôte ou depuis l'intérieur du conteneur MongoDB :

   # depuis l'hôte, si mongodump est installé
   mongodump --uri="mongodb://localhost:27017/rocketchat" --out /tmp/rc-dump
   
   # ou depuis le conteneur Docker
   docker exec <mongo-container> mongodump \
     --db rocketchat --out /dump
   docker cp <mongo-container>:/dump /tmp/rc-dump

   Vérifiez que /tmp/rc-dump/rocketchat/ contient bien des fichiers .bson et .json pour les collections rocketchat_message, users, rocketchat_room, etc.

3. 03

   Exporter les fichiers joints (uploads)

   Les fichiers joints stockés dans GridFS ou dans le système de fichiers local ne font pas partie du dump MongoDB — ils doivent être copiés séparément.

   Si vous utilisez le stockage local (option par défaut) :

   docker cp <rocketchat-container>:/app/uploads /tmp/rc-uploads

   Si vous utilisez un bucket S3 compatible, notez les paramètres de connexion — vous les reconfigurerez dans Mattermost. mmetl référence les fichiers joints mais ne les transfère pas : vous les pousserez manuellement ou via mmctl import avec l'option --attachments-dir.

4. 04

   Exporter les utilisateurs via l'API REST (optionnel)

   Pour un inventaire des comptes avant migration, l'API Rocket.Chat permet d'exporter la liste des utilisateurs actifs. Cela facilite la vérification croisée après import Mattermost :

   curl -H "X-Auth-Token: <token>" \
        -H "X-User-Id: <admin-id>" \
        "https://chat.yourdomain.com/api/v1/users.list?count=200" \
     | python3 -c "import sys,json; [print(u['username'], u.get('emails',[{}])[0].get('address','')) for u in json.load(sys.stdin)['users']]"

   Gardez cette liste : elle sert à vérifier que tous les comptes sont bien créés dans Mattermost après le bulk import.

Installer Mattermost sur votre VPS

1. 05

   Récupérer la configuration Docker Compose officielle

   L'équipe Mattermost maintient un dépôt docker avec une configuration Compose prête à l'emploi :

   git clone https://github.com/mattermost/docker /opt/mattermost
   cd /opt/mattermost
   cp env.example .env

   Ouvrez .env et renseignez au minimum :

   DOMAIN=chat.yourdomain.com
   MM_SERVICESETTINGS_SITEURL=https://chat.yourdomain.com
   POSTGRES_USER=mmuser
   POSTGRES_PASSWORD=<mot-de-passe-fort>
   POSTGRES_DB=mattermost

2. 06

   Monter les volumes et démarrer la stack

   Créez les répertoires de volumes avant le premier démarrage :

   mkdir -p ./volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}
   sudo chown -R 2000:2000 ./volumes/app/mattermost

   Démarrez la stack complète (Mattermost + PostgreSQL + nginx avec certificat Let's Encrypt intégré) :

   docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d

   Attendez que le conteneur Mattermost soit healthy avant de continuer :

   docker compose ps

3. 07

   Créer le compte administrateur

   Ouvrez https://chat.yourdomain.com dans votre navigateur. À la première connexion, Mattermost propose la création du compte administrateur. Renseignez l'e-mail, le nom d'utilisateur et le mot de passe de l'administrateur initial — ce compte sera distinct des comptes importés depuis Rocket.Chat.

   Une fois connecté, allez dans System Console → Environment → Site URL et vérifiez que l'URL correspond exactement à celle déclarée dans .env.

Migrer l'historique et les utilisateurs avec mmetl

1. 08

   Installer mmetl

   Téléchargez le binaire mmetl v0.6.0 (publié le 11 septembre 2026) depuis les releases GitHub :

   curl -L https://github.com/mattermost/mmetl/releases/download/v0.6.0/mmetl-linux-amd64 \
     -o /usr/local/bin/mmetl
   chmod +x /usr/local/bin/mmetl
   mmetl version

   Changement de syntaxe v0.6.0 : la sous-commande mmetl check a été supprimée. Utilisez désormais mmetl transform ... --dry-run pour valider le dump avant de produire le fichier d'import.

2. 09

   Transformer le dump Rocket.Chat en fichier d'import Mattermost

   Lancez la transformation en indiquant le répertoire contenant les collections BSON exportées (le sous-dossier rocketchat du dump) et le nom de l'équipe Mattermost cible :

   mmetl transform rocketchat \
     --team mon-equipe \
     --dump-dir /tmp/rc-dump/rocketchat \
     --output /tmp/mattermost-import

   mmetl génère un fichier import.jsonl et un répertoire bulk-export-attachments/. Pour tester sans générer d'output :

   mmetl transform rocketchat \
     --team mon-equipe \
     --dump-dir /tmp/rc-dump/rocketchat \
     --dry-run

   Vérifiez les avertissements : les messages de canaux privés sans membre reconnu sont sautés, les pièces jointes absentes du répertoire d'uploads sont référencées mais non transférées.

3. 10

   Lancer l'import dans Mattermost via mmctl

   Copiez le fichier d'import dans le répertoire de données Mattermost, puis lancez le bulk import :

   # copier dans le conteneur
   docker cp /tmp/mattermost-import/import.jsonl \
     <mattermost-container>:/mattermost/data/import.jsonl
   
   # lancer l'import depuis mmctl (dans le conteneur)
   docker exec <mattermost-container> mmctl import bulk \
     /mattermost/data/import.jsonl --bypass-upload

   Pour suivre l'avancement, consultez les jobs d'import dans System Console → Bulk Import. Les erreurs sont logguées ligne par ligne — un import partiel ne bloque pas le reste.

4. 11

   Vérifier le résultat et les limites connues

   Après l'import, vérifiez les points suivants :
   - Les canaux publics et privés doivent être présents dans Mattermost avec leur historique.
   - Les noms d'utilisateurs sont importés mais les mots de passe ne le sont pas — chaque utilisateur doit réinitialiser son mot de passe ou se connecter via LDAP si l'annuaire est configuré.
   - Les pièces jointes nécessitent un second passage avec --attachments-dir pointant vers le répertoire copié depuis Rocket.Chat.
   - Les threads de discussion (fils imbriqués) sont aplatis si la structure n'est pas reconnue.

Configurer LDAP dans Mattermost Community

1. 12

   Activer LDAP dans la System Console

   Dans System Console → Authentication → AD/LDAP, activez LDAP et renseignez les paramètres de connexion :

   LDAP Server: ldap.yourdomain.com (ou l'IP de votre contrôleur de domaine)
   Port: 389 (LDAP) ou 636 (LDAPS)
   Bind Username: cn=mattermost-svc,ou=serviceaccounts,dc=yourdomain,dc=com
   Bind Password: <mot-de-passe-du-compte-de-service>
   Base DN: ou=users,dc=yourdomain,dc=com

   Activez LDAP over TLS (LDAPS) ou StartTLS si votre infrastructure le permet — ne transmettez pas les identifiants en clair sur un réseau non chiffré.

   LDAP et SAML sont inclus dans l'édition Community de Mattermost sans condition de plan payant — documenté dans la [Documentation officielle Mattermost AD/LDAP](https://docs.mattermost.com/onboard/ad-ldap.html) qui couvre l'édition Team/open source.

2. 13

   Configurer les mappings d'attributs

   Mattermost lit les attributs LDAP pour peupler les profils. Les mappings courants pour Active Directory :

   ID Attribute:        objectGUID  (ou sAMAccountName si l'GUID n'est pas disponible)
   Username Attribute:  sAMAccountName
   Email Attribute:     mail
   First Name:          givenName
   Last Name:           sn

   Pour OpenLDAP, remplacez sAMAccountName par uid et objectGUID par entryUUID.

   Dans User Filter, restreignez la synchronisation aux membres du groupe voulu :

   (memberOf=cn=mattermost-users,ou=groups,dc=yourdomain,dc=com)

3. 14

   Tester la connexion et synchroniser

   Cliquez sur AD/LDAP Test en bas de la page pour valider la connexion et le bind. En cas d'erreur LDAP Result Code 49 'Invalid Credentials', vérifiez le DN du compte de service et son mot de passe.

   Déclenchez une première synchronisation manuelle via AD/LDAP Synchronize Now. Les utilisateurs dont l'attribut e-mail correspond à un compte déjà importé via mmetl seront liés automatiquement — ils se connecteront ensuite avec leurs identifiants LDAP sans avoir à réinitialiser leur mot de passe.

Dépannage courant

ldapsearch -x -H ldap://ldap.yourdomain.com \
  -D "cn=mattermost-svc,ou=serviceaccounts,dc=yourdomain,dc=com" \
  -W -b "ou=users,dc=yourdomain,dc=com" "(uid=testuser)"

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

Rocket.Chat Community 9.0 vs Mattermost Community

Faites défiler le tableau

Mattermost Community, une plateforme stable pour le long terme