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

# Ottenere aiuto

### Il Doctor

Overleaf Toolkit include un pratico `doctor` script per aiutare nel debug. Esegui `bin/doctor` e lo script stamperà informazioni sul tuo ambiente host, sulla tua configurazione e sulle dipendenze necessarie al Toolkit. Questo output può anche aiutare il team di supporto di Overleaf a diagnosticare i problemi per le installazioni Server Pro.

{% hint style="info" %}
Gli utenti di Overleaf Pro possono [aprire una segnalazione su GitHub](https://github.com/ayaka-notes/overleaf/issues).

è una buona idea includere l'output dello `bin/doctor` script nel tuo messaggio.
{% endhint %}

### Consultare il Doctor <a href="#consulting-with-the-doctor" id="consulting-with-the-doctor"></a>

Esegui lo script doctor:

{% code title="Esegui doctor" %}

```bash
bin/doctor
```

{% endcode %}

Vedrai un output simile all'esempio qui sotto.

<details>

<summary>Esempio di output completo</summary>

```
====== Overleaf Doctor ======
- Informazioni host
    - Linux
    - Output di 'lsb_release -a':
            Nessun modulo LSB è disponibile.
            ID distributore:	Ubuntu
            Descrizione:	Ubuntu 22.04.5 LTS
            Versione:	22.04
            Nome in codice:	jammy
- Dipendenze
    - bash
        - stato: presente
        - info versione: 5.1.16(1)-release
    - docker
        - stato: presente
        - informazioni versione: Docker version 28.0.4, build b8034c0
    - docker compose
        - stato: presente
        - informazioni versione: Docker Compose version v2.34.0
    - realpath
        - stato: presente
        - info versione: realpath (GNU coreutils) 8.32
    - perl
        - stato: presente
        - info versione: 5.034000
    - awk
        - stato: presente
        - informazioni versione: mawk 1.3.4 20200120
- Demone Docker
    - stato: attivo
====== Configurazione ======
- config/version
    - stato: presente
    - versione: 5.4.0
- config/overleaf.rc
    - stato: presente
    - valori
        - OVERLEAF_DATA_PATH: data/overleaf
        - OVERLEAF_LOG_PATH: data/overleaf/logs
        - SERVER_PRO: true
        - SIBLING_CONTAINERS_ENABLED: true
            - accesso a quay.io eseguito: true
        - MONGO_ENABLED: true
        - REDIS_ENABLED: true
- config/variables.env
    - stato: presente
    - valori
        - OVERLEAF_FILESTORE_BACKEND: fs
        - OVERLEAF_HISTORY_BACKEND: fs

====== Avvisi ======
- Nessuno, tutto bene
====== Fine ======
```

</details>

### Informazioni sull'host

Il `Informazioni sull'host` la sezione contiene informazioni sulla macchina che esegue il Toolkit (ad esempio, distribuzione e versione di Linux).

<details>

<summary>Esempio di output delle informazioni sull'host</summary>

```
- Informazioni host
    - Linux
    - Output di 'lsb_release -a':
            Nessun modulo LSB è disponibile.
            ID distributore:	Ubuntu
            Descrizione:	Ubuntu 22.04.5 LTS
            Versione:	22.04
            Nome in codice:	jammy
```

</details>

### Dipendenze

Il `Dipendenze` la sezione elenca gli strumenti necessari al funzionamento del Toolkit. Se uno strumento è presente, verrà elencato come `stato: presente` con le informazioni sulla versione. Se manca, verrà elencato come `stato: MANCANTE!` e verrà aggiunto un avviso in fondo all' `doctor` output.

<details>

<summary>Esempio di output delle dipendenze (presente)</summary>

```
- docker
    - stato: presente
    - informazioni versione: Docker version 28.0.4, build b8034c0
```

</details>

<details>

<summary>Esempio di output delle dipendenze (mancante)</summary>

```
- docker
    - stato: MANCANTE!
```

</details>

Se mancano dipendenze, il Toolkit quasi certamente non funzionerà.

### Configurazione

Il `Configurazione` la sezione contiene informazioni sui file nella `config/` cartella. Per `config/overleaf.rc`, il doctor stampa alcuni valori chiave. I file mancanti verranno elencati come `stato: MANCANTE!` e verrà aggiunto un avviso in fondo all' `doctor` output.

<details>

<summary>Esempio di output della configurazione</summary>

```
====== Configurazione ======
- config/version
    - stato: presente
    - versione: 5.4.0
- config/overleaf.rc
    - stato: presente
    - valori
        - OVERLEAF_DATA_PATH: /tmp/overleaf
        - SERVER_PRO: false
        - MONGO_ENABLED: false
        - REDIS_ENABLED: true
- config/variables.env
    - stato: MANCANTE!
```

</details>

Note dall'esempio sopra:

* `OVERLEAF_DATA_PATH` impostato su `/tmp/overleaf` potrebbe non essere un percorso sicuro per dati importanti.
* `MONGO_ENABLED: false` significa che il Toolkit non predisporrà un proprio MongoDB; assicurati `MONGO_URL` che punti a un MongoDB gestito esternamente, se necessario.
* `config/variables.env` è mancante nell'esempio.

### Avvisi

Il `Avvisi` la sezione riassume i problemi rilevati dallo script doctor. Se non ci sono problemi, questa sezione lo indicherà.

<details>

<summary>Esempio di output degli avvisi</summary>

```
====== Avvisi ======
- file di configurazione variables.env non trovato
- file rc, OVERLEAF_DATA_PATH non impostato
====== Fine =======
```

</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/it/supporto/getting-help.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.
