Migrar Rocket.Chat a Mattermost en un VPS

Qué cambia en Rocket.Chat 9.0

Por qué Mattermost Community es una alternativa sólida

• LDAP y SAML incluidos sin licencia — Mattermost distribuye la autenticación Active Directory y SAML en su edición de código abierto, bajo licencia MIT para el servidor (Apache 2.0 para contribuciones), sin requisito de plan de pago.
• PostgreSQL nativo — Mattermost se apoya en PostgreSQL, bien documentado, fácil de respaldar con pg_dump y más común que MongoDB en entornos Docker autoalojados.
• mmetl, una herramienta oficial de migración — la herramienta mmetl del equipo de Mattermost transforma un mongodump de Rocket.Chat en un archivo de importación JSONL compatible con mmctl import, incluyendo canales, usuarios y mensajes.
• Menor huella de memoria — Mattermost puede arrancar con 2 GB de RAM para equipos de menos de cincuenta usuarios; Rocket.Chat requiere un replica set de MongoDB que consume más a volumen equivalente.
• Aplicaciones oficiales de escritorio y móvil — los clientes iOS, Android, macOS y Windows apuntan a tu propio dominio desde la instalación.
• Historial y archivos adjuntos ilimitados — sin ventana deslizante, sin corte por volumen de mensajes, todo almacenado en tu disco o bucket S3.

Requisitos previos cuantificados

Hacer copia de seguridad de Rocket.Chat

1. 01

   Poner Rocket.Chat en modo solo lectura

   Antes de cualquier copia de seguridad, notifica a tus usuarios y pon la instancia en modo mantenimiento. En la administración de Rocket.Chat, ve a Administración → General → Modo mantenimiento y activa el modo de solo lectura.

   Alternativamente, si no dispones de este modo, simplemente detén el contenedor de Rocket.Chat:

   docker compose stop rocketchat

2. 02

   Exportar la base de datos MongoDB con mongodump

   mmetl espera un directorio producido por mongodump, no un archivo comprimido. Ejecuta el dump desde el host o desde dentro del contenedor MongoDB:

   # desde el host, si mongodump está instalado
   mongodump --uri="mongodb://localhost:27017/rocketchat" --out /tmp/rc-dump
   
   # o desde el contenedor Docker
   docker exec <mongo-container> mongodump \
     --db rocketchat --out /dump
   docker cp <mongo-container>:/dump /tmp/rc-dump

   Verifica que /tmp/rc-dump/rocketchat/ contiene archivos .bson y .json para las colecciones rocketchat_message, users, rocketchat_room, etc.

3. 03

   Exportar los archivos adjuntos (uploads)

   Los archivos adjuntos almacenados en GridFS o en el sistema de archivos local no forman parte del dump de MongoDB — deben copiarse por separado.

   Si utilizas almacenamiento local (opción predeterminada):

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

   Si utilizas un bucket S3 compatible, anota los parámetros de conexión — los reconfigura-rás en Mattermost.

4. 04

   Exportar usuarios via REST API (opcional)

   Para un inventario de cuentas antes de la migración, la API de Rocket.Chat permite exportar la lista de usuarios activos:

   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']]"

   Conserva esta lista para verificar que todas las cuentas se han creado correctamente en Mattermost tras la importación masiva.

Instalar Mattermost en tu VPS

1. 05

   Obtener la configuración oficial de Docker Compose

   El equipo de Mattermost mantiene un repositorio docker con una configuración Compose lista para usar:

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

   Abre .env y rellena como mínimo:

   DOMAIN=chat.yourdomain.com
   MM_SERVICESETTINGS_SITEURL=https://chat.yourdomain.com
   POSTGRES_USER=mmuser
   POSTGRES_PASSWORD=<contraseña-segura>
   POSTGRES_DB=mattermost

2. 06

   Crear los volúmenes y arrancar el stack

   Crea los directorios de volúmenes antes del primer arranque:

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

   Arrancar el stack completo (Mattermost + PostgreSQL + nginx con certificado Let's Encrypt integrado):

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

   Espera a que el contenedor de Mattermost esté healthy antes de continuar.

3. 07

   Crear la cuenta de administrador

   Abre https://chat.yourdomain.com en tu navegador. En el primer acceso, Mattermost solicita la creación de una cuenta de administrador. Introduce el correo electrónico, el nombre de usuario y la contraseña del administrador inicial — esta cuenta será independiente de las cuentas importadas desde Rocket.Chat.

Migrar el historial y los usuarios con mmetl

1. 08

   Instalar mmetl

   Descarga el binario de mmetl v0.6.0 (publicado el 11 de septiembre de 2026) desde las releases de 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

   Cambio importante en v0.6.0: el subcomando mmetl check ha sido eliminado. Usa mmetl transform ... --dry-run para validar el dump antes de producir el archivo de importación.

2. 09

   Transformar el dump de Rocket.Chat en un archivo de importación de Mattermost

   Ejecuta la transformación apuntando al directorio que contiene las colecciones BSON exportadas (la subcarpeta rocketchat del dump) y el nombre del equipo de Mattermost destino:

   mmetl transform rocketchat \
     --team mi-equipo \
     --dump-dir /tmp/rc-dump/rocketchat \
     --output /tmp/mattermost-import

   mmetl genera un archivo import.jsonl y un directorio bulk-export-attachments/. Para probar sin generar salida:

   mmetl transform rocketchat \
     --team mi-equipo \
     --dump-dir /tmp/rc-dump/rocketchat \
     --dry-run

3. 10

   Ejecutar la importación en Mattermost via mmctl

   Copia el archivo de importación en el directorio de datos de Mattermost, luego ejecuta la importación masiva:

   # copiar al contenedor
   docker cp /tmp/mattermost-import/import.jsonl \
     <mattermost-container>:/mattermost/data/import.jsonl
   
   # ejecutar la importación desde mmctl (dentro del contenedor)
   docker exec <mattermost-container> mmctl import bulk \
     /mattermost/data/import.jsonl --bypass-upload

   Para seguir el progreso, consulta los trabajos de importación en System Console → Bulk Import.

4. 11

   Verificar resultados y limitaciones conocidas

   Después de la importación, verifica los siguientes puntos:
   - Los canales públicos y privados deben estar presentes en Mattermost con su historial.
   - Los nombres de usuario se importan pero las contraseñas no — cada usuario debe restablecer su contraseña o iniciar sesión via LDAP si el directorio está configurado.
   - Los archivos adjuntos requieren un segundo paso con --attachments-dir.
   - Los hilos de discusión (respuestas anidadas) se aplanan si la estructura no es reconocida.

Configurar LDAP en Mattermost Community

1. 12

   Activar LDAP en la System Console

   En System Console → Authentication → AD/LDAP, activa LDAP y rellena los parámetros de conexión:

   LDAP Server: ldap.yourdomain.com (o la IP de tu controlador de dominio)
   Port: 389 (LDAP) o 636 (LDAPS)
   Bind Username: cn=mattermost-svc,ou=serviceaccounts,dc=yourdomain,dc=com
   Bind Password: <contraseña-de-la-cuenta-de-servicio>
   Base DN: ou=users,dc=yourdomain,dc=com

   Activa LDAP over TLS (LDAPS) o StartTLS si tu infraestructura lo permite.

2. 13

   Configurar los mapeos de atributos

   Mattermost lee atributos LDAP para completar los perfiles. Mapeos comunes para Active Directory:

   ID Attribute:        objectGUID
   Username Attribute:  sAMAccountName
   Email Attribute:     mail
   First Name:          givenName
   Last Name:           sn

   Para OpenLDAP, sustituye sAMAccountName por uid y objectGUID por entryUUID.

   En User Filter, restringe la sincronización a los miembros del grupo deseado:

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

3. 14

   Probar la conexión y sincronizar

   Haz clic en AD/LDAP Test en la parte inferior de la página para validar la conexión y el bind. Si obtienes LDAP Result Code 49 'Invalid Credentials', verifica el DN de la cuenta de servicio y su contraseña.

   Dispara una primera sincronización manual a través de AD/LDAP Synchronize Now. Los usuarios cuyo atributo de correo coincida con una cuenta ya importada via mmetl se vincularán automáticamente.

Resolución de problemas comunes

Rocket.Chat Community 9.0 vs Mattermost Community

Desplace la tabla

Mattermost Community, una plataforma estable a largo plazo