> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/es/soporte/troubleshooting.md).

# Solución de problemas

{% hint style="info" %}
Si está utilizando una versión anterior, use `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 dar lugar a distintos tipos de errores de rendimiento.

Un error común que se observa durante las compilaciones es:

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

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

Para `docker-compose` configuraciones basadas en, sugerimos simplemente sobrescribir el montaje enlazado desde NFS, lo que evita cambiar las rutas en la aplicación. Aquí hay un ejemplo de un `docker-compose` extracto de configuración que usa un disco temporal montado en `/scratch`:

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

```yaml
services:
  sharelatex:
    entorno:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volúmenes:
      - 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 ningún archivo existente del NFS a su nueva ubicación después de la actualización. El compilador de LaTeX puede recrear todos los archivos ejecutando de nuevo una compilación completa.

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

</details>

<details>

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

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

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

```
Error al iniciar WiredTiger bajo cualquier versión de compatibilidad.
Motivo: 1: Operación no permitida
```

{% endcode %}

Para evitar este error, los datos deben almacenarse en un volumen en lugar de un directorio montado como enlace (consulte 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 datos dentro de volúmenes de Docker montados en los contenedores de MongoDB y Redis, agregue lo siguiente a `config/docker-compose.override.yml` (cree este archivo si aún no existe):

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

```yaml
volúmenes:
  mongo-data:
  redis-data:

services:
  mongo:
    volúmenes:
      - mongo-data:/data/db

  redis:
    volúmenes:
      - redis-data:/data
```

{% endcode %}

Para más información, consulte: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Actualizar a Redis 6.2 provoca un bucle de reinicios</summary>

Use el `docker logs redis` comando para generar una copia de los registros.

Si ve la línea `Fatal: no se pueden inicializar los trabajos en segundo plano`, 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 oO0OoO0OoO0OoO0OoO0OoO0Oo
```

{% endcode %}

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

Para más información, consulte el problema upstream 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á que seguir los pasos siguientes para cada plantilla afectada:

Busque el ID de la plantilla. Vaya a la galería de plantillas de su instancia (/templates/all), abra una plantilla afectada y copie el ID de la URL (por ejemplo: <https://your-instance-url/templates/6645d346c224815e9460a695>). Ejecute el comando de corrección. Ejecute el siguiente comando desde el host de Docker (reemplace el ID de la plantilla por el que copió y actualice 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>Verifique que haya habilitado las llamadas al sistema. Para pdflatex, esto es 'pdflatex -shell-escape'.</summary>

El `\write18` el comando está deshabilitado de forma predeterminada en la Edición Community debido a que todas las compilaciones se realizan dentro del mismo `sharelatex` contenedor; esta es la opción predeterminada más segura.

Si desea habilitarlo para pdflatex, cree un `latexmkrc` archivo en la raíz de su proyecto con el siguiente contenido:

{% code title="latexmkrc" %}

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

{% endcode %}

Luego intente 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://overleaf-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.