> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/es/soporte/troubleshooting.md).

# Solución de problemas

{% hint style="info" %}
Si estás usando una versión anterior, usa `sharelatex` en lugar de `overleaf` en los nombres de ruta.
{% endhint %}

<details>

<summary>Ejecutar Overleaf con un sistema de archivos NFS</summary>

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 común que ven las compilaciones es:

```
EBUSY: recurso ocupado o bloqueado, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

En particular, desaconsejamos el uso de sistemas de archivos respaldados por NFS para datos efímeros, como los directorios usados para los datos de compilación. Recomendamos usar un disco temporal local, preferiblemente un SSD local, para los siguientes directorios.

Para `docker-compose` basadas, sugerimos simplemente sobrescribir el bind-mount desde NFS, lo que evita cambiar rutas en la aplicación. Aquí tienes un ejemplo de un `docker-compose` fragmento de configuración con el uso de un disco temporal montado en `/scratch`:

{% code title="fragmento de docker-compose" %}

```yaml
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
```

{% endcode %}

No es necesario migrar ninguno de los archivos existentes desde NFS a su nueva ubicación después de la actualización. El compilador de LaTeX puede recrear todos los archivos con otra ejecución completa de compilación.

Para más detalles, consulta: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Ejecutar Overleaf en Windows o macOS provoca que el servicio `mongo` no se inicie</summary>

Si estás ejecutando Overleaf en Windows o macOS, el `mongo` servicio puede no reiniciarse, con un error:

{% code title="Ejemplo de error" %}

```
No se pudo iniciar WiredTiger bajo ninguna versión de compatibilidad.
Razón: 1: Operación no permitida
```

{% endcode %}

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

{% code title="config/docker-compose.override.yml" %}

```yaml
volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

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>

</details>

<details>

<summary>La actualización a Redis 6.2 provoca un bucle de reinicio</summary>

Usa el `docker logs redis` comando para mostrar una copia de los registros.

Si ves la línea `Fatal: Can't initialize Background Jobs`, la salida completa se verá más o menos así:

{% code title="Ejemplo de registro de Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Servidor inicializado
1:M 11 Feb 2024 15:19:22.609 # Fatal: No se pueden inicializar los trabajos en segundo plano.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis se está iniciando oO0OoO0OoO0Oo
```

{% endcode %}

Esto puede estar relacionado con la versión de Docker que se está usando actualmente. Actualizar a una versión >= 20.10.10 debería resolver este problema.

Para más información, consulta el problema aguas arriba 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>

</details>

<details>

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

En ocasiones, las imágenes de vista previa/miniatura generadas por Server Pro pueden crearse con la orientación incorrecta y requerir intervención manual para corregirlas. Estas imágenes se almacenan en `/var/lib/overleaf/data/template_files/` (>= 5.0.3) y `/var/lib/sharelatex/data/template_files/` (anteriores).

Recomendamos hacer una copia de seguridad de esta carpeta antes de realizar cualquier cambio.

Tendrás que seguir los pasos a continuación para cada plantilla afectada:

Encuentra el ID de la plantilla. Ve 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ón. Ejecuta el siguiente comando desde el host Docker (reemplaza 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>

</details>

<details>

<summary>Verifica que hayas habilitado las llamadas al sistema. Para pdflatex, esto es 'pdflatex -shell-escape'.</summary>

La `\write18` comando está deshabilitado por defecto en la Community Edition debido a que todas las compilaciones ocurren dentro del mismo `sharelatex` contenedor; este es el valor predeterminado más seguro.

Si deseas habilitarlo para pdflatex, crea un `latexmkrc` archivo en la raíz de tu proyecto con el siguiente contenido:

{% code title="latexmkrc" %}

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

{% endcode %}

Luego intenta recompilar.

Referencia: <https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/es/soporte/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.