> 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/configurazione/overleaf-toolkit/files-and-locations.md).

# File e posizioni

Questa pagina descrive i file di configurazione utilizzati dal Toolkit per configurare la tua distribuzione on-premises di Overleaf.

### Dati persistenti

L'Overleaf Toolkit deve memorizzare dati persistenti, come i file necessari per compilare i progetti LaTeX e il contenuto del database MongoDB. Questo si ottiene montando alcune directory dalla macchina host nei contenitori Docker e scrivendo i dati in tali directory.

#### Directory dei dati

Il `sharelatex` il contenitore richiede una directory in cui memorizzare i dati relativi alle compilazioni LaTeX. Questa directory viene impostata con la `OVERLEAF_DATA_PATH` variabile in `config/overleaf.rc`.

Il `mongo` il contenitore, se è abilitato, richiede una directory in cui memorizzare i file del database, e lo stesso vale per il `redis` contenitore. Queste directory possono anche essere configurate in `config/overleaf.rc`.

#### Permessi dei file

Poiché Docker viene eseguito come `root`, le directory dei dati risulteranno di proprietà dell' `root` utente, anche se il Toolkit viene utilizzato da un utente non root. Non è un problema, ma è utile esserne consapevoli se si intende modificare i dati persistenti dall'esterno dei contenitori.

### Posizione del file di configurazione

Tutti i file di configurazione di proprietà dell'utente si trovano nella `config/` directory.

Questa directory è **esclusa** dal sistema di controllo delle revisioni git, quindi non verrà modificata aggiornando il codice del Toolkit. Il Toolkit **non** modificherà tutti i dati nella `config/` directory senza il tuo permesso.

{% hint style="info" %}
Le modifiche ai file di configurazione non verranno applicate automaticamente ai contenitori esistenti, anche se il contenitore viene arrestato e riavviato (con `bin/stop` e `bin/start`). Per applicare le modifiche, esegui `bin/up`, e dietro le quinte, `docker compose` applicherà automaticamente le modifiche di configurazione a un nuovo contenitore. (Oppure, esegui `bin/up -d`, se preferisci non collegarti ai log di Docker.)
{% endhint %}

### Il `overleaf.rc` file

Il `config/overleaf.rc` file contiene le impostazioni di configurazione di livello superiore più importanti utilizzate dal Toolkit. Contiene istruzioni che impostano variabili, nel formato: `VARIABLE_NAME=value`

Per vedere una panoramica di tutte le opzioni di configurazione disponibili, consulta la nostra sezione impostazioni.

### Il `variables.env` file

Il `config/variables.env` file contiene variabili d'ambiente che vengono caricate nel `sharelatex` contenitore e utilizzate per configurare i microservizi di Overleaf. Queste includono il nome dell'applicazione, come visualizzato nell'intestazione dell'interfaccia web, le impostazioni per l'invio delle email e altre impostazioni premium, come l'SSO da usare con Server Pro.

Per vedere una panoramica di tutte le variabili d'ambiente disponibili, consulta le [variabili d'ambiente](broken://pages/099abc4cdcf99f423da228365f3af28ff3e50ddb) sezione.

### Il `versione` file

Il `config/version` file contiene il numero di versione dell'immagine Docker che verrà utilizzata per creare l'istanza in esecuzione del tuo server Overleaf.

{% hint style="info" %}
Le modifiche a questi file di configurazione non verranno applicate automaticamente ai contenitori esistenti, anche se il contenitore viene arrestato e riavviato (con `bin/stop` e `bin/start`). Per applicare le modifiche, esegui `bin/up`, e il Toolkit creerà automaticamente per te un nuovo contenitore con le modifiche di configurazione applicate.
{% endhint %}

### Il `docker-compose.override.yml` file

Se presente, il `config/docker-compose.override.yml` file verrà incluso nella chiamata a `docker compose`. Questo è utile per sovrascrivere la configurazione specifica di Docker Compose.

Consulta la [documentazione di docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) per ulteriori dettagli.


---

# 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/configurazione/overleaf-toolkit/files-and-locations.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.