> 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/it/supporto/troubleshooting.md).

# Risoluzione dei problemi

{% hint style="info" %}
Se stai usando una versione precedente, usa `sharelatex` invece di `Overleaf` nei nomi dei percorsi.
{% endhint %}

<details>

<summary>Esecuzione di Overleaf con un filesystem NFS</summary>

Montare un filesystem NFS in un container Overleaf è tecnicamente possibile, ma non è consigliato e può causare diversi tipi di errori di prestazioni.

Un errore comune che i compilatori vedono è:

```
EBUSY: risorsa occupata o bloccata, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

In particolare sconsigliamo l'uso di filesystem supportati da NFS per dati effimeri, come le directory usate per i dati di compilazione. Consigliamo di usare un disco scratch locale, preferibilmente un SSD locale, per le seguenti directory.

Per `docker-compose` basate, suggeriamo semplicemente di sovrascrivere il bind-mount da NFS, evitando così di modificare i percorsi nell'applicazione. Ecco un esempio di `docker-compose` estratto di configurazione con l'uso di un disco scratch montato in `/scratch`:

{% code title="estratto di docker-compose" %}

```yaml
servizi:
  sharelatex:
    ambiente:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumi:
      - 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 %}

Non è necessario migrare eventuali file esistenti da NFS alla loro nuova destinazione dopo l'aggiornamento. Il compilatore LaTeX può ricreare tutti i file eseguendo di nuovo una compilazione completa.

Per maggiori dettagli, vedi: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>L'esecuzione di Overleaf su Windows o macOS fa sì che il servizio `mongo` non si avvii</summary>

Se stai eseguendo Overleaf su Windows o macOS, il `mongo` servizio potrebbe non riuscire a riavviarsi, con un errore:

{% code title="Errore di esempio" %}

```
Impossibile avviare WiredTiger con alcuna versione di compatibilità.
Motivo: 1: Operazione non consentita
```

{% endcode %}

Per evitare questo errore, i dati devono essere archiviati in un volume anziché in una directory montata tramite bind (vedi la `mongo` documentazione dell'immagine per maggiori dettagli: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Per archiviare i dati all'interno di volumi Docker montati nei contenitori MongoDB e Redis, aggiungi quanto segue a `config/docker-compose.override.yml` (crea questo file se non esiste ancora):

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

```yaml
volumi:
  mongo-data:
  redis-data:

servizi:
  mongo:
    volumi:
      - mongo-data:/data/db

  redis:
    volumi:
      - redis-data:/data
```

{% endcode %}

Per ulteriori informazioni, vedi: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>L'aggiornamento a Redis 6.2 provoca un ciclo di riavvio</summary>

Usa il `docker logs redis` comando per visualizzare una copia dei log.

Se vedi la riga `Fatale: impossibile inizializzare i lavori in background`, l'output completo sarà simile a questo:

{% code title="Esempio di log di Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server inizializzato
1:M 11 Feb 2024 15:19:22.609 # Fatale: impossibile inizializzare i lavori in background.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis si sta avviando oO0OoO0OoO0Oo
```

{% endcode %}

Questo potrebbe essere correlato alla versione di Docker attualmente in uso. L'aggiornamento a una versione >= 20.10.10 dovrebbe risolvere questo problema.

Per ulteriori informazioni, vedi il problema upstream di Redis: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Orientamento errato delle immagini di anteprima/miniatura della galleria dei template</summary>

Talvolta, le immagini di anteprima/miniatura generate da Server Pro possono essere create con l'orientamento sbagliato e richiedere un intervento manuale per correggerle. Queste immagini sono archiviate in `/var/lib/overleaf/data/template_files/` (>= 5.0.3) e `/var/lib/sharelatex/data/template_files/` (precedenti).

Consigliamo di eseguire un backup di questa cartella prima di apportare qualsiasi modifica.

Dovrai seguire i passaggi seguenti per ogni template interessato:

Trova l'ID del templateVai alla galleria dei template della tua istanza (/templates/all), apri un template interessato e copia l'ID dall'URL (per esempio: <https://your-instance-url/templates/6645d346c224815e9460a695).Esegui> il comando di correzioneEsegui il seguente comando dall'host Docker (sostituisci l'ID del template con quello che hai copiato e aggiorna il percorso se appropriato):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Riferimento: <https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images>

</details>

<details>

<summary>Verifica di aver abilitato le chiamate di sistema. Per pdflatex, questo è 'pdflatex -shell-escape'.</summary>

Il `\write18` Il comando è disabilitato per impostazione predefinita nella Community Edition perché tutte le compilazioni avvengono all'interno dello stesso `sharelatex` container; questa è l'impostazione predefinita più sicura.

Se desideri abilitarlo per pdflatex, crea un `latexmkrc` file nella radice del tuo progetto con il seguente contenuto:

{% code title="latexmkrc" %}

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

{% endcode %}

Poi prova a ricompilare.

Riferimento: <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/it/supporto/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.