> 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/redis.md).

# Redis

### Activation de l’authentification par mot de passe

Si vous utilisez un service Redis externe et devez fournir un mot de passe, vous pouvez le faire en définissant les `OVERLEAF_REDIS_PASS` et `REDIS_PASSWORD` variables d’environnement dans le **config/variables.env** fichier et en exécutant la `bin/up -d` commande pour recréer le **conteneur sharelatex.** conteneur.

Si vous exécutez une instance locale de Redis, vous devrez configurer le **redis** service pour démarrer avec l’authentification par mot de passe. Après avoir défini les variables d’environnement ci-dessus, vous devrez également suivre ces étapes supplémentaires :

Créez un **docker-compose.override.yml** fichier dans le **config/** répertoire avec le contenu suivant :

{% code title="config/docker-compose.override.yml" %}

```yaml
services:
    redis:
        commande : « redis-server --requirepass <YOUR-PASSWORD> »
```

{% endcode %}

{% hint style="warning" %}
Si vous avez activé la persistance AOF, vous devrez ajouter `--appendonly yes` sur `commande`.
{% endhint %}

Exécutez `bin/up -d` pour recréer les conteneurs.

### Activation de la persistance Append-Only File

(Original : <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/redis#enabling-append-only-file-persistence>)

La persistance AOF (Append-Only File) de Redis offre un moyen robuste d’assurer la durabilité des données en journalisant chaque opération d’écriture reçue par le serveur. Contrairement aux instantanés RDB, qui prennent des copies ponctuelles de votre jeu de données, AOF conserve un enregistrement complet de toutes les modifications apportées à vos données.

{% hint style="info" %}
La désactivation de RDB est facultative. Il est généralement recommandé d’utiliser les deux méthodes de persistance ensemble. Avant d’apporter des modifications en production, examinez les avantages et les inconvénients de l’utilisation conjointe de AOF et RDB.
{% endhint %}

Vous pouvez en savoir plus sur l’activation de la persistance AOF dans Redis ici : <https://redis.io/docs/latest/operate/oss_and_stack/management/persistence/#how-i-can-switch-to-aof-if-im-currently-using-dumprdb-snapshotsarrow-up-right>

1. Planifiez une fenêtre de maintenance pour la mise à niveau.
2. Arrêtez l’instance à l’aide de `bin/stop` et effectuez une sauvegarde des **config/** et **data/** dossiers.
3. Exécutez `bin/up` pour démarrer l’instance
4. Exécutez la commande `docker exec -it redis sh`
5. Exécutez la commande `redis-cli` pour ouvrir l’interface de ligne de commande Redis
6. Dans redis-cli, exécutez la commande `config set appendonly yes`
7. Vous devrez maintenant attendre la fin de la réécriture AOF pour que les données soient conservées. Vous pouvez le faire en saisissant `INFO persistence` dans redis-cli et en attendant que `aof_rewrite_in_progress` et `aof_rewrite_scheduled` soit `0`, puis en vérifiant que `aof_last_bgrewrite_status` est `ok`.
8. Quittez redis-cli en saisissant `exit` et en appuyant sur la touche Retour
9. Quittez le conteneur Redis en saisissant `exit` et en appuyant sur la touche Retour
10. Exécutez la commande `ls ./data/redis` et vérifiez que vous pouvez voir le **appendonly.aof** fichier
11. Modifiez le **config/overleaf.rc** fichier et modifiez la `REDIS_AOF_PERSISTENCE` variable d’environnement de `false` à `true`
12. Exécutez `bin/up -d` et assurez-vous que l’application fonctionne (l’éditeur de projet et le volet d’historique sont opérationnels).


---

# 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/redis.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.