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

# File e percorsi

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. Ciò avviene montando alcune directory dalla macchina host nei container Docker e scrivendo i dati in quelle directory.

#### Directory dei dati

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

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

#### Permessi dei file

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

### 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 **non** modificherà alcun dato nella `config/` directory senza il tuo permesso.

{% hint style="info" %}
Le modifiche ai file di configurazione non verranno applicate automaticamente ai container esistenti, anche se il container viene fermato e riavviato (con `bin/stop` e `bin/start`). Per applicare le modifiche, esegui `bin/up`, e in background, `docker compose` applicherà automaticamente le modifiche di configurazione a un nuovo container. (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 primo livello più importanti utilizzate dal Toolkit. Contiene istruzioni che impostano variabili, nel formato: `NOME_VARIABILE=valore`

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` container 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 la [Variabili d'ambiente](broken://pages/099abc4cdcf99f423da228365f3af28ff3e50ddb) sezione.

### Il `versione` file

Il `config/version` file contiene il numero di versione dell'immagine Docker che verrà usata 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 container esistenti, anche se il container viene fermato e riavviato (con `bin/stop` e `bin/start`). Per applicare le modifiche, esegui `bin/up`, e il Toolkit creerà automaticamente per te un nuovo container 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 configurazioni specifiche di Docker Compose.

Consulta la [documentazione di docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) per maggiori 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://ayakaleaf-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.