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

# Ottenere aiuto

### Il Dottore

L'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 Overleaf a diagnosticare problemi per le installazioni di Server Pro.

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

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

### Consultazione con il Dottore <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 seguente.

<details>

<summary>Esempio di output completo</summary>

```
====== Overleaf Doctor ======
- Informazioni sull'host
    - Linux
    - Output di 'lsb_release -a':
            Non sono disponibili moduli LSB.
            ID distributore:	Ubuntu
            Descrizione:	Ubuntu 22.04.5 LTS
            Rilascio:	22.04
            Nome in codice:	jammy
- Dipendenze
    - bash
        - stato: presente
        - info versione: 5.1.16(1)-release
    - docker
        - stato: presente
        - info versione: Docker version 28.0.4, build b8034c0
    - docker compose
        - stato: presente
        - info 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
        - info 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 effettuato a quay.io: 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 sull'host
    - Linux
    - Output di 'lsb_release -a':
            Non sono disponibili moduli LSB.
            ID distributore:	Ubuntu
            Descrizione:	Ubuntu 22.04.5 LTS
            Rilascio:	22.04
            Nome in codice:	jammy
```

</details>

### Dipendenze

Il `Dipendenze` la sezione elenca gli strumenti richiesti per il 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 un avviso verrà aggiunto in fondo all' `doctor` output.

<details>

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

```
- docker
    - stato: presente
    - info 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/` directory. Per `config/overleaf.rc`, il doctor stampa alcuni valori chiave. I file mancanti verranno elencati come `stato: MANCANTE!` e un avviso verrà aggiunto 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` punti a un MongoDB gestito esternamente, se necessario.
* `config/variables.env` manca nell'esempio.

### Avvisi

Il `Avvisi` la sezione riassume i problemi individuati 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://overleaf-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.
