> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas

<Info>
  Si usas una versión anterior, utiliza `sharelatex` en lugar de `overleaf` en los nombres de las rutas.
</Info>

<Accordion title="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:

  ```text theme={null}
  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`:

  ```yaml title="docker-compose excerpt" theme={null}
  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem)
</Accordion>

<Accordion title="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:

  ```text title="Example error" theme={null}
  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](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):

  ```yaml title="config/docker-compose.override.yml" theme={null}
  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting)
</Accordion>

<Accordion title="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:

  ```text title="Redis log example" theme={null}
  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](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](https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop)
</Accordion>

<Accordion title="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](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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="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:

  ```perl title="latexmkrc" theme={null}
  $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](https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape)
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.