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

# 5. Personnaliser votre instance

### Personnalisation de votre instance <a href="#personalizing-your-instance" id="personalizing-your-instance"></a>

Avant de démarrer votre instance Overleaf pour la première fois, mettez à jour le `config/variables.env` fichier de configuration avec vos informations personnalisées.

{% stepper %}
{% step %}

### Modifiez le fichier des variables

Ouvrir `config/variables.env` dans votre éditeur de texte préféré et mettez à jour les variables d’environnement ci-dessous avec les valeurs requises.
{% endstep %}

{% step %}

### Variables d’environnement requises

Mettez à jour les variables suivantes dans `config/variables.env`:

| Nom                           | Description                                                                                                                                                                                      | Exemple                         |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
| `OVERLEAF_SITE_URL`           | L’endroit où votre instance Overleaf est accessible publiquement. Ceci est utilisé dans les liens publics et lors de la connexion via les websockets, donc **doit être configuré correctement**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | Cette adresse e-mail sera utilisée comme adresse `expéditeur` pour tous les e-mails sortants.                                                                                                    | `no-reply@lilliput.com`         |
| `OVERLEAF_ADMIN_EMAIL`        | L’adresse e-mail où les utilisateurs peuvent joindre la personne qui gère le site.                                                                                                               | `it-services@lilliput.com`      |

Une fois que vous avez mis à jour ces variables d’environnement, enregistrez et quittez.
{% endstep %}

{% step %}

### Démarrer votre instance

Pour démarrer votre instance, exécutez :

{% code title="Démarrer l’instance" %}

```
bin/up
```

{% endcode %}

Cette commande téléchargera les images requises, créera les conteneurs (en utilisant vos personnalisations) et démarrera l’instance. Vous devriez voir la sortie des journaux des différents conteneurs Docker.

Pour les redémarrer plus tard (sans les rattacher à la sortie des journaux), exécutez :

{% code title="Démarrer sans rattacher aux journaux" %}

```
bin/start
```

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

{% hint style="info" %}
Le Toolkit utilise `docker compose` pour gérer les conteneurs Docker d’Overleaf. Le Toolkit fournit un ensemble de scripts qui encapsulent `docker compose` et s’occupent de la plupart des détails pour vous.
{% endhint %}

Si tout se passe bien, vous devriez pouvoir voir la page de connexion de votre nouvelle instance Overleaf en accédant à <http://127.0.0.1/> ou <http://localhost/> dans votre navigateur.

{% hint style="warning" %}
Selon la configuration de votre réseau et l’emplacement d’hébergement de votre instance Overleaf, vous devrez peut-être effectuer des changements de configuration supplémentaires. Consultez les paramètres du Toolkit pour plus de détails :

<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://ayakaleaf-pro.ayaka.space/on-premises/fr/installation/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.