> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fichiers et emplacements

Cette page décrit les fichiers de configuration utilisés par le Toolkit pour configurer votre déploiement sur site d'Overleaf.

### Données persistantes

Le Toolkit Overleaf doit stocker des données persistantes, comme les fichiers nécessaires à la compilation des projets LaTeX et le contenu de la base de données MongoDB. Pour cela, quelques répertoires de la machine hôte sont montés dans les conteneurs Docker, et les données sont écrites dans ces répertoires.

#### Répertoires de données

Le conteneur `sharelatex` a besoin d'un répertoire dans lequel stocker les données relatives aux compilations LaTeX. Ce répertoire est défini avec la variable `OVERLEAF_DATA_PATH` dans `config/overleaf.rc`.

Le conteneur `mongo`, s'il est activé, a besoin d'un répertoire pour stocker ses fichiers de base de données, et il en va de même pour le conteneur `redis`. Ces répertoires peuvent également être configurés dans `config/overleaf.rc`.

#### Permissions des fichiers

Comme Docker s'exécute en tant que `root`, les répertoires de données appartiendront à l'utilisateur `root`, même si le Toolkit est utilisé par un utilisateur non root. Ce n'est pas un problème, mais il est bon de le savoir si vous comptez modifier les données persistantes depuis l'extérieur des conteneurs.

### Emplacement des fichiers de configuration

Tous les fichiers de configuration appartenant à l'utilisateur se trouvent dans le répertoire `config/`.

Ce répertoire est **exclu** du système de gestion de versions git ; il ne sera donc pas modifié par la mise à jour du code du Toolkit. Le Toolkit ne modifiera **aucune** donnée du répertoire `config/` sans votre autorisation.

<Info>
  Les modifications apportées aux fichiers de configuration ne sont pas appliquées automatiquement aux conteneurs existants, même si le conteneur est arrêté puis redémarré (avec `bin/stop` et `bin/start`). Pour appliquer les modifications, exécutez `bin/up` : en coulisses, `docker compose` appliquera automatiquement les changements de configuration à un nouveau conteneur. (Ou exécutez `bin/up -d` si vous préférez ne pas vous attacher aux journaux Docker.)
</Info>

### Le fichier `overleaf.rc`

Le fichier `config/overleaf.rc` contient les paramètres de configuration de premier niveau les plus importants utilisés par le Toolkit. Il contient des instructions qui définissent des variables, au format : `VARIABLE_NAME=value`

Pour obtenir le détail de toutes les options de configuration disponibles, consultez notre section sur les paramètres.

### Le fichier `variables.env`

Le fichier `config/variables.env` contient les variables d'environnement chargées dans le conteneur `sharelatex` et utilisées pour configurer les microservices d'Overleaf. Elles comprennent le nom de l'application, tel qu'affiché dans l'en-tête de l'interface web, les paramètres d'envoi d'e-mails et d'autres paramètres premium comme le SSO à utiliser avec Server Pro.

Pour obtenir le détail de toutes les variables d'environnement disponibles, consultez la section [Variables d'environnement](/fr/on-premises/configuration/overleaf-toolkit/environment-variables).

### Le fichier `version`

Le fichier `config/version` contient le numéro de version de l'image Docker qui sera utilisée pour créer l'instance en cours d'exécution de votre serveur Overleaf.

<Info>
  Les modifications apportées à ces fichiers de configuration ne sont pas appliquées automatiquement aux conteneurs existants, même si le conteneur est arrêté puis redémarré (avec `bin/stop` et `bin/start`). Pour appliquer vos modifications, exécutez `bin/up` : le Toolkit créera automatiquement un nouveau conteneur avec les changements de configuration appliqués.
</Info>

### Le fichier `docker-compose.override.yml`

S'il est présent, le fichier `config/docker-compose.override.yml` sera inclus dans l'appel à `docker compose`. C'est utile pour surcharger la configuration propre à Docker Compose.

Consultez la [documentation de docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) pour plus de détails.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.