> 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/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`           | Où votre instance Overleaf est accessible publiquement. Ceci est utilisé dans les liens publics et lors des connexions via WebSockets, donc **doit être configuré correctement**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | Cette adresse e-mail sera utilisée comme l’adresse `d’expéditeur` pour tous les e-mails sortants.                                                                                 | `no-reply@lilliput.com`         |
| `OVERLEAF_ADMIN_EMAIL`        | L’adresse e-mail à laquelle les utilisateurs peuvent joindre la personne qui gère le site.                                                                                        | `it-services@lilliput.com`      |

Une fois ces variables d’environnement mises à jour, enregistrez et quittez.
{% endstep %}

{% step %}

### Démarrez 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 vous attacher à la sortie des journaux), exécutez :

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

```
bin/start
```

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

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

Si tout se passe bien, vous devriez pouvoir afficher 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’endroit où votre instance Overleaf est hébergée, vous devrez peut-être effectuer des modifications 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://overleaf-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.