Saltar al contenido principal
Cualquier nueva versión de Ayakaleaf Pro indicará en sus notas de la versión cualquier cambio en la versión de MongoDB admitida.

¿Debo actualizar MongoDB?

Solo deberías plantearte actualizar tu versión de MongoDB si tienes previsto actualizar tu instancia de Ayakaleaf Pro. Si ejecutas una versión de MongoDB más reciente que la recomendada para tu versión actual (o de destino), no es necesario hacer ningún cambio.
Nunca debes volver a una versión anterior de MongoDB.
Si experimentas un problema concreto que crees que podría estar relacionado con tu versión actual de MongoDB, no dudes en abrir una incidencia.

Comprobar tu versión de MongoDB

Al abrir la shell de mongo debería mostrarse inmediatamente la versión actual. Usuarios del Overleaf Toolkit:
Usuarios de Docker Compose:

Proceso de actualización

La actualización de la versión de MongoDB durante una actualización de tu instancia de Ayakaleaf Pro se realiza de la siguiente manera:
  1. Decide a qué versión de Ayakaleaf Pro tienes previsto actualizar.
  2. Busca la versión de MongoDB recomendada por esa versión concreta de Ayakaleaf Pro.
  3. Sigue las instrucciones para actualizar MongoDB a la versión de destino.
  4. Actualiza la versión de la imagen de Ayakaleaf Pro y reinicia la instancia.
Recomendamos actualizar siempre a la última versión disponible.
Al actualizar Ayakaleaf Pro, recomendamos actualizar a la última versión de la versión principal desplegada antes de actualizar a la última versión de la siguiente versión principal. Si tu despliegue está más de una versión principal por detrás de la última, tendrás que realizar una actualización en varios pasos.Por ejemplo, si ejecutas la 6.2.0, actualiza primero a la 6.2.2 y después a la 6.3.2; consulta Actualizar tu despliegue.Nunca debes saltarte versiones (6.2.0 -> 6.3.2). Si usas el Toolkit y estás más de una versión principal por detrás de la última, no debes usar el script bin/upgrade, ya que tendrás que realizar una actualización manual en varios pasos.
Es importante que hagas una copia de seguridad consistente antes de cada actualización de versión principal, para poder revertir los cambios si lo necesitas.

Información sobre versiones compatibles

Si decides pasar a una versión anterior, esta tabla muestra la versión de MongoDB recomendada para versiones anteriores, pero nunca debes volver a una versión anterior de MongoDB. La tabla enumera versiones de Overleaf. Las imágenes de Ayakaleaf Pro empiezan en la 6.0.0: la 6.0.0 necesita MongoDB 6.0 o posterior, y la 6.0.1 y posteriores necesitan MongoDB 8.0 o posterior con la versión de compatibilidad de funcionalidades 7.0. Con un MongoDB más antiguo, el contenedor se detiene durante el arranque.
Versión de OverleafVersión de MongoDBVersión mínima de compatibilidad de funcionalidadesVersión máxima admitida por el driver de Node.js
2.0.x3.4--
2.1.x a 2.4.x3.6--
>=2.5.04.0--
>=3.1.04.2--
>=3.2.04.4--
>=4.2.05.0--
>=5.1.06.0--
>=5.3.16.05.08.0
>=5.5.06.06.08.0
>=6.0.08.07.08.0
La versión mínima de compatibilidad de funcionalidades indicada arriba se basa en la versión de MongoDB correspondiente recomendada para usarse con la versión de Overleaf mostrada. Si tienes previsto usar una versión superior, MongoDB tendrá su propio requisito mínimo.
Puedes consultar la tabla de compatibilidad que especifica las versiones del driver de Node.js de MongoDB compatibles con MongoDB aquí. Puedes consultar el estado de fin de vida de cada versión de MongoDB aquí.

Actualizar MongoDB

MongoDB requiere actualizaciones paso a paso. Esto significa que no puedes pasar directamente, por ejemplo, de 4.0 a 5.0. Primero tienes que actualizar de 4.2 a 4.4 y, después, a 5.0.
MongoDB usa números pares para sus versiones estables.

Instrucciones de actualización cuando MongoDB se ejecuta fuera de Docker

Estos son los enlaces a las instrucciones de actualización de mongodb.com para actualizar MongoDB.
Las instrucciones para 5.0 y superiores hacen referencia a una instalación como replica set, en lugar de independiente. Como Ayakaleaf Pro usa transacciones, MongoDB debe ejecutarse como replica set.
La documentación de MongoDB 3.2 a 4.2 está ahora disponible en https://www.mongodb.com/docs/legacy/
Instrucciones básicas En la mayoría de los casos, la actualización requiere establecer un indicador de compatibilidad antes de actualizar realmente la versión de mongo. Los pasos son los siguientes:
  1. Establece el indicador de compatibilidad como se describe en las notas de la versión de MongoDB (consulta los ejemplos más abajo).
  2. A continuación, actualiza la imagen de mongo:
    1. Usuarios del Toolkit: actualiza MONGO_VERSION, por ejemplo MONGO_VERSION=6.0
    2. Usuarios de Docker Compose: actualiza la versión de la etiqueta de la imagen mongo,
      por ejemplo services -> mongo -> image: mongo:6.0;
Ejemplo: actualizar MongoDB de 5.0 a 6.0 Empecemos por asegurarnos de que estamos ejecutando MongoDB 6.0: Usuarios del Overleaf Toolkit:
Usuarios de Docker Compose:
Según las instrucciones de actualización, el único requisito es tener featureCompatibilityVersion establecido en 5.0. Para ello, abrimos una shell de MongoDB y ejecutamos el comando indicado: Usuarios del Overleaf Toolkit:
Los usuarios de Docker Compose pueden ejecutar docker compose exec mongo mongosh para obtener una shell y ejecutar los mismos comandos que los usuarios del Toolkit.
Usuarios del Overleaf Toolkit: A continuación, detendremos las instancias de Ayakaleaf Pro y de MongoDB con el comando bin/stop, estableceremos MONGO_VERSION=6.0 en config/overleaf.rc y reiniciaremos el servicio mongo con bin/up mongo para comprobar que la actualización se ha realizado sin problemas. Por último, actualizaremos la versión de la imagen de Ayakaleaf Pro a nuestra versión de destino y recrearemos todos los servicios con el comando bin/up -d. Usuarios de Docker Compose: A continuación, detendremos las instancias de Ayakaleaf Pro y de MongoDB con el comando docker compose stop, actualizaremos el archivo docker-compose.yml para usar image: mongo:6.0 y reiniciaremos el servicio mongo con el comando docker compose up mongo para comprobar que la actualización se ha realizado sin problemas. Por último, actualizaremos la versión de la imagen de Ayakaleaf Pro a nuestra versión de destino y recrearemos todos los servicios con el comando docker compose up. Empieza por asegurarte de que estás ejecutando MongoDB 6.0 con los comandos mongod --version anteriores. Según las instrucciones de actualización, el único requisito es tener featureCompatibilityVersion establecido en 6.0. Para ello, abrimos una shell de MongoDB y ejecutamos el comando db.adminCommand({ setFeatureCompatibilityVersion: "6.0" }). Usuarios del Overleaf Toolkit:
A continuación, detendremos las instancias de Ayakaleaf Pro y de MongoDB con el comando bin/stop, estableceremos MONGO_VERSION=7.0 en config/overleaf.rc y reiniciaremos el servicio mongo con bin/up mongo para comprobar que la actualización se ha realizado sin problemas. Por último, actualizaremos la versión de la imagen de Ayakaleaf Pro a nuestra versión de destino y recrearemos todos los servicios con el comando bin/up -d. Empieza por asegurarte de que estás ejecutando MongoDB 7.0 con los comandos mongod --version anteriores. Según las instrucciones de actualización, el único requisito es tener featureCompatibilityVersion establecido en 7.0. Para ello, abrimos una shell de MongoDB y ejecutamos el comando db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true }). Ten en cuenta que ahora se requiere el parámetro adicional confirm: true.
A continuación, detendremos las instancias de Ayakaleaf Pro y de MongoDB con el comando bin/stop, estableceremos MONGO_VERSION=8.0 en config/overleaf.rc y reiniciaremos el servicio mongo con bin/up mongo para comprobar que la actualización se ha realizado sin problemas. Por último, actualizaremos la versión de la imagen de Ayakaleaf Pro a nuestra versión de destino y recrearemos todos los servicios con el comando bin/up -d.

Comandos equivalentes para usuarios de docker compose

Para los usuarios de docker compose, los comandos equivalentes son:
  • docker compose exec mongo mongod --version para mostrar la versión de mongo
  • docker compose exec mongo mongosh para iniciar una shell de mongo para comandos de administración
  • el comando docker compose stop para detener el servidor
  • Edita el archivo docker-compose.yml para usar image: mongo:6.0 y así actualizar la versión de mongo
  • docker compose up mongo para reiniciar el servicio mongo y comprobar que la actualización se ha realizado sin problemas
  • Edita el archivo docker-compose.yml para usar image: sharelatex:VERSION y así actualizar la versión de la imagen
  • docker compose up para recrear todos los servicios.

Crear un rol personalizado

En la versión 5.5.1 introdujimos una comprobación al inicio para verificar la versión de compatibilidad de funcionalidades de MongoDB. Si tu base de datos MongoDB usa autenticación (por ejemplo, autenticación básica), es posible que el contenedor sharelatex no se inicie y muestre un error de permisos “not authorized on admin to execute command”. Para resolverlo, puedes crear un nuevo rol en MongoDB y asignarlo a la cuenta de usuario utilizada para acceder a la base de datos siguiendo las instrucciones de abajo, o establecer ALLOW_MONGO_ADMIN_CHECK_FAILURES=true para permitir que la comprobación falle sin impedir que se inicie el despliegue.
Este nuevo rol solo concede permiso para leer los parámetros del servidor MongoDB a nivel de clúster y podría reutilizarse con fines de monitorización.

Q&A

Respuesta: Ninguna. La imagen más antigua de Ayakaleaf Pro, la 6.0.0, necesita MongoDB 6.0, y la 6.0.1 y posteriores necesitan MongoDB 8.0. Para ejecutar Ayakaleaf Pro sobre un MongoDB 4.4 existente, actualiza MongoDB una versión principal cada vez (4.4 → 5.0 → 6.0 → 7.0 → 8.0) como se describe en Actualizar MongoDB, con una copia de seguridad antes de cada paso.
Última modificación el 8 de noviembre de 2026