Solución de problemas

Si usas una versión anterior, utiliza sharelatex en lugar de overleaf en los nombres de las rutas.

Ejecutar Overleaf con un sistema de archivos NFS

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:

EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'

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

services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp

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

Al ejecutar Overleaf en Windows o macOS, el servicio mongo no se inicia

Si ejecutas Overleaf en Windows o macOS, es posible que el servicio mongo no se reinicie y muestre el error:

Example error

Failed to start up WiredTiger under any compatibility version.
Reason: 1: Operation not permitted

Para evitar este error, los datos deben almacenarse en un volumen en lugar de en un directorio montado mediante bind mount (consulta la documentación de la imagen mongo para más detalles: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). Para almacenar los datos en volúmenes de Docker montados dentro de los contenedores de MongoDB y Redis, añade lo siguiente a config/docker-compose.override.yml (crea este archivo si aún no existe):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data

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

Actualizar a Redis 6.2 provoca un bucle de reinicios

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

1:M 11 Feb 2024 15:19:22.609 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo

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/12362

Referencia: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop

Orientación incorrecta de las imágenes de vista previa/miniatura de la galería de plantillas

En ocasiones, las imágenes de vista previa/miniatura generadas por Server 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/ (>= 5.0.3) y en /var/lib/sharelatex/data/template_files/ (versiones anteriores).

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

Please verify that you have enabled system calls. For pdflatex, this is 'pdflatex -shell-escape'.

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

$pdflatex = 'pdflatex --shell-escape';

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