> 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/configuration/overleaf-toolkit/files-and-locations.md). # Fichiers et emplacements Cette page décrit les fichiers de configuration utilisés par le Toolkit pour configurer votre déploiement d’Overleaf sur site. ### Données persistantes Le Toolkit Overleaf doit stocker des données persistantes, telles que les fichiers nécessaires à la compilation des projets LaTeX et le contenu de la base de données MongoDB. Cela est réalisé en montant quelques répertoires de la machine hôte dans les conteneurs Docker et en écrivant les données dans ces répertoires. #### Répertoires de données Le `conteneur sharelatex.` le conteneur nécessite un répertoire dans lequel stocker les données relatives aux compilations LaTeX. Ce répertoire est défini avec la `OVERLEAF_DATA_PATH` variable dans `config/overleaf.rc`. Le `mongo` le conteneur, s’il est activé, nécessite un répertoire dans lequel stocker ses fichiers de base de données, et il en va de même pour le `redis` conteneur. 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 finiront par appartenir à l’utilisateur `root` , même si le Toolkit est utilisé par un utilisateur non root. Ce n’est pas un problème, mais cela vaut la peine de le savoir si vous prévoyez de modifier les données persistantes depuis l’extérieur des conteneurs. ### Emplacement du fichier de configuration Tous les fichiers de configuration appartenant à l’utilisateur se trouvent dans le `config/` répertoire. Ce répertoire est **exclu** du système de contrôle de révision git, il ne sera donc pas modifié lors de la mise à jour du code du Toolkit. Le Toolkit ne **ne pas** modifiera aucune donnée dans le `config/` répertoire sans votre permission. {% hint style="info" %} Les modifications apportées aux fichiers de configuration ne seront pas automatiquement appliquées 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`, et, en coulisses, `docker compose` appliquera automatiquement les modifications de configuration à un nouveau conteneur. (Ou exécutez `bin/up -d`, si vous préférez ne pas vous attacher aux journaux Docker.) {% endhint %} ### Le `overleaf.rc` fichier Le `config/overleaf.rc` fichier contient les paramètres de configuration de niveau supérieur les plus importants utilisés par le Toolkit. Il contient des instructions qui définissent des variables, au format : `VARIABLE_NAME=value` Pour voir le détail de toutes les options de configuration disponibles, consultez notre section des paramètres. ### Le `variables.env` fichier Le `config/variables.env` fichier contient des variables d’environnement qui sont chargées dans le `conteneur sharelatex.` conteneur et utilisées pour configurer les microservices Overleaf. Cela inclut 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 tels que le SSO à utiliser avec Server Pro. Pour voir le détail de toutes les variables d’environnement disponibles, consultez la [variables d’environnement](broken://pages/041c64a7cf3d677e6f9e23dfacc6cd3a17fc6d53) section. ### Le `version` fichier Le `config/version` fichier 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. {% hint style="info" %} Les modifications apportées à ces fichiers de configuration ne seront pas automatiquement appliquées 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`, et le Toolkit créera automatiquement pour vous un nouveau conteneur avec les modifications de configuration appliquées. {% endhint %} ### Le `docker-compose.override.yml` fichier Si elle est présente, la `config/docker-compose.override.yml` fichier sera incluse dans l’appel à `docker compose`. Cela est utile pour remplacer la configuration spécifique à Docker Compose. Voir la [documentation de docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) pour plus de détails. --- # 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/configuration/overleaf-toolkit/files-and-locations.md?ask=&goal= ``` `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.