Saltar al contenido principal
Si usas una versión anterior, utiliza sharelatex en lugar de overleaf en los nombres de las rutas.
Montar un sistema de archivos NFS en un contenedor de Overleaf es técnicamente posible, pero no se recomienda y puede provocar distintos tipos de errores de rendimiento.Un error habitual que aparece en las compilaciones es:
En particular, desaconsejamos usar sistemas de archivos basados en NFS para datos efímeros, como los directorios que se usan para los datos de compilación. Recomendamos usar un disco temporal local, preferiblemente un SSD local, para los siguientes directorios.En las instalaciones basadas en docker-compose, sugerimos simplemente sobrescribir el bind-mount de NFS, lo que evita cambiar rutas en la aplicación. Este es un ejemplo de un fragmento de configuración de docker-compose que usa un disco temporal montado en /scratch:
docker-compose excerpt
No es necesario migrar ningún archivo existente desde el NFS a su nueva ubicación tras la actualización. El compilador de LaTeX puede volver a crear todos los archivos con una nueva compilación completa.Para más detalles, consulta: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Si ejecutas Overleaf en Windows o macOS, es posible que el servicio mongo no se reinicie y muestre el error:
Example error
Esto puede ocurrir cuando los datos de MongoDB se montan mediante bind mount desde un sistema de archivos que no proporciona la semántica que necesita, como un directorio montado desde Windows. Para Windows con WSL 2, mantén el Toolkit en el directorio personal de Linux de Ubuntu y usa los bind mounts predeterminados. Consulta las comprobaciones de MongoDB de la guía de la plataforma.Para una instalación nueva que necesite almacenamiento gestionado por Docker, el siguiente override usa volúmenes con nombre (consulta las indicaciones de almacenamiento de la imagen de MongoDB). En una instalación existente, cambiar los montajes no migra los datos: haz una copia de seguridad y restaura la base de datos/caché antes del cambio, o el servicio verá volúmenes vacíos. Añade esto a config/docker-compose.override.yml, combinándolo con cualquier configuración existente:
config/docker-compose.override.yml
Para más información, consulta: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Usa el comando docker logs redis para obtener una copia de los registros.Si ves la línea Fatal: Can't initialize Background Jobs, la salida completa tendrá un aspecto similar a este:
Redis log example
Esto puede estar relacionado con la versión de Docker que estás usando. Actualizar a una versión >= 20.10.10 debería resolver el problema.Para más información, consulta la incidencia original de Redis: https://github.com/redis/redis/issues/12362Referencia: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
En ocasiones, las imágenes de vista previa/miniatura generadas por Ayakaleaf Pro pueden crearse con una orientación incorrecta y requerir una intervención manual para corregirlas. Estas imágenes se almacenan en /var/lib/overleaf/data/template_files/.Recomendamos hacer una copia de seguridad de esta carpeta antes de realizar cualquier cambio.Tendrás que seguir los pasos siguientes para cada plantilla afectada:Busca el ID de la plantillaVe a la galería de plantillas de tu instancia (/templates/all), abre una plantilla afectada y copia el ID de la URL (por ejemplo: https://your-instance-url/templates/6645d346c224815e9460a695).Ejecuta el comando de correcciónEjecuta el siguiente comando desde el host de Docker (sustituye el ID de la plantilla por el que copiaste y actualiza la ruta si corresponde):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Referencia: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
El comando \write18 está deshabilitado de forma predeterminada en Community Edition, ya que todas las compilaciones se realizan dentro del mismo contenedor sharelatex; esta es la opción predeterminada más segura.Si quieres habilitarlo para pdflatex, crea un archivo latexmkrc en la raíz de tu proyecto con el siguiente contenido:
latexmkrc
A continuación, vuelve a compilar.Referencia: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Estos errores significan que el contenedor mongo se bloquea y se reinicia continuamente. bin/up inicia MongoDB y después ejecuta un comando dentro de él, que falla mientras el contenedor se reinicia. bin/docker-compose ps muestra el servicio mongo como Restarting.Para encontrar la causa real, lee el registro de MongoDB:
Las causas habituales son:
  • La CPU no admite AVX. MongoDB 5.0 y posteriores necesitan AVX en x86-64, y el registro muestra MongoDB 5.0+ requires a CPU with AVX support. En una máquina virtual, establece el tipo de CPU en host para que AVX se transfiera.
  • Kernel de Linux 6.19 a 7.0.13. MongoDB se niega a iniciarse con estos kernels. Consulta Requisitos de software para ver la solución alternativa.
  • Los datos los creó una versión anterior de MongoDB. MongoDB 8.0 no puede abrir directamente datos de 4.4 o 5.0. Actualiza una versión principal cada vez; consulta Actualizar MongoDB.
Es lo esperado con Ayakaleaf Pro y puedes ignorarlo. El mensaje se muestra cuando OVERLEAF_IS_SERVER_PRO no es true, que es lo que ocurre en la imagen de Ayakaleaf Pro. Ayakaleaf Pro no necesita esta variable, así que déjala sin definir.
Antes de que Overleaf se inicie, el contenedor ejecuta comprobaciones de arranque y se cierra cuando una de ellas falla. El Toolkit lo ejecuta con restart: always, por lo que Docker lo vuelve a iniciar y la misma comprobación vuelve a fallar. La salida de arranque indica la comprobación que ha fallado:
Las causas más comunes son:
  • Missing required secrets: establece OVERLEAF_INVITE_TOKEN_SECRET en config/variables.env; consulta Variables de entorno.
  • ShareLaTeX to Overleaf rebranding: la configuración sigue usando variables o rutas SHARELATEX_; renómbralas como indica el mensaje.
  • Un error después de Checking can connect to mongo and redis: Overleaf no puede conectarse a MongoDB o Redis. Revisa bin/logs mongo y bin/logs redis.
Después de corregir la causa, ejecuta bin/up -d.
En cada arranque, el contenedor ejecuta sus scripts de inicio uno tras otro, y el registro nombra cada uno como *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery solo tiene trabajo que hacer en instancias que alguna vez ejecutaron Overleaf 5.0.1. En cualquier otra instancia imprime No recovery of doc versions needed. y el arranque continúa. Su salida también va a data/history/doc-version-recovery.log en OVERLEAF_DATA_PATH.El código de salida y el final de bin/docker-compose logs --tail=100 sharelatex indican lo que ocurrió:
  • Código de salida 2, y el registro termina con *** Init system aborted.: el contenedor se detuvo, por ejemplo con bin/stop, docker stop o Ctrl+C en bin/up. El script de la última línea Running es solo el que se estaba ejecutando en ese momento; no falló. Vuelve a iniciar el contenedor con bin/up -d y deja que el arranque termine.
  • Código de salida 1, y el registro muestra *** /etc/my_init.d/<script> failed with status <n>: ese script falló, y su error aparece en las líneas inmediatamente anteriores. Si 910_initiate_doc_version_recovery falló con Detected unflushed changes while recovering doc versions, la instancia ejecutó la versión 5.0.1 y todavía tiene ediciones sin volcar; sigue la guía oficial de recuperación de versiones de documentos.
Esta página se muestra cuando tu cuenta ha iniciado sesión pero no tiene permiso para abrir la página, por ejemplo, una página de administración abierta por una cuenta que no es administradora o un proyecto que no se ha compartido contigo.Para abrir las páginas de administración, inicia sesión con una cuenta de administrador. Un administrador existente puede convertir otra cuenta en administradora, o puedes crear una con el comando create-user --admin; consulta Gestión de usuarios. En el entorno de desarrollo (develop/), las páginas de administración también necesitan ADMIN_PRIVILEGE_AVAILABLE=true en develop/dev.env; la imagen de Ayakaleaf Pro ya lo establece.
Última modificación el 8 de noviembre de 2026