> 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/installazione/using-the-toolkit/5.-personalizing-your-instance.md).

# 5. Personalizzazione della tua istanza

### Personalizzazione della tua istanza <a href="#personalizing-your-instance" id="personalizing-your-instance"></a>

Prima di avviare la tua istanza Overleaf per la prima volta, aggiorna il `config/variables.env` file di configurazione con le tue informazioni personalizzate.

{% stepper %}
{% step %}

### Modifica il file delle variabili

Apri `config/variables.env` nel tuo editor di testo preferito e aggiorna le variabili d'ambiente qui sotto con i valori richiesti.
{% endstep %}

{% step %}

### Variabili d'ambiente richieste

Aggiorna le seguenti variabili in `config/variables.env`:

| Nome                          | Descrizione                                                                                                                                                                                    | Esempio                         |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| `OVERLEAF_SITE_URL`           | Dove la tua istanza di Overleaf è disponibile pubblicamente. Questo viene usato nei link pubblici e quando ci si connette tramite websocket, quindi **deve essere configurato correttamente**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | Questo indirizzo email verrà usato come il `mittente` indirizzo per tutte le email in uscita.                                                                                                  | `no-reply@lilliput.com`         |
| `OVERLEAF_ADMIN_EMAIL`        | L'indirizzo email tramite cui gli utenti possono contattare la persona che gestisce il sito.                                                                                                   | `it-services@lilliput.com`      |

Una volta aggiornate queste variabili d'ambiente, salva e chiudi.
{% endstep %}

{% step %}

### Avvia la tua istanza

Per avviare la tua istanza esegui:

{% code title="Avvia l'istanza" %}

```
bin/up
```

{% endcode %}

Questo comando scaricherà le immagini richieste, creerà i container (usando le tue personalizzazioni) e avvierà l'istanza. Dovresti vedere l'output dei log dai vari container Docker.

Per riavviarli in seguito (senza collegarti all'output dei log) esegui:

{% code title="Avvia senza collegarti ai log" %}

```
bin/start
```

{% endcode %}
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Il Toolkit usa `docker compose` per gestire i container Docker di Overleaf. Il Toolkit fornisce una serie di script che avvolgono `docker compose` e si occupano per te della maggior parte dei dettagli.
{% endhint %}

Se tutto va bene, dovresti essere in grado di visualizzare la pagina di accesso della tua nuova istanza Overleaf andando su <http://127.0.0.1/> oppure <http://localhost/> nel tuo browser.

{% hint style="warning" %}
A seconda della configurazione della tua rete e di dove è ospitata la tua istanza Overleaf, potresti dover apportare ulteriori modifiche alla configurazione. Consulta le impostazioni del Toolkit per maggiori dettagli:

<https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/toolkit-settings>
{% endhint %}


---

# 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/installazione/using-the-toolkit/5.-personalizing-your-instance.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.