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

# Redis

### Włączanie uwierzytelniania hasłem

Jeśli korzystasz z zewnętrznej usługi Redis i musisz podać hasło, możesz to zrobić, ustawiając zmienne środowiskowe `OVERLEAF_REDIS_PASS` oraz `REDIS_PASSWORD` w pliku **config/variables.env** i uruchamiając polecenie `bin/up -d`, aby odtworzyć kontener **sharelatex**.

Jeśli uruchamiasz lokalną instancję Redis, musisz skonfigurować usługę **redis** tak, aby uruchamiała się z uwierzytelnianiem hasłem. Po ustawieniu powyższych zmiennych środowiskowych musisz wykonać również następujące dodatkowe kroki:

Utwórz plik **docker-compose.override.yml** w katalogu <strong>config/</strong> o następującej zawartości:

```yaml title="config/docker-compose.override.yml" theme={null}
services:
    redis:
        command: "redis-server --requirepass <YOUR-PASSWORD>"
```

<Warning>
  Jeśli masz włączoną trwałość AOF, musisz dodać `--appendonly yes` do `command`.
</Warning>

Uruchom `bin/up -d`, aby odtworzyć kontenery.

### Włączanie trwałości Append-Only File

(Oryginał: [https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/redis#enabling-append-only-file-persistence](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/redis#enabling-append-only-file-persistence))

Trwałość Redis AOF (Append-Only File) zapewnia solidny sposób gwarantowania trwałości danych poprzez rejestrowanie każdej operacji zapisu otrzymanej przez serwer. W przeciwieństwie do migawek RDB, które tworzą kopie zbioru danych z określonego momentu, AOF przechowuje pełny zapis wszystkich zmian wprowadzonych w danych.

<Info>
  Wyłączenie RDB jest opcjonalne. Ogólnie zaleca się stosowanie obu metod trwałości jednocześnie. Przed wprowadzeniem jakichkolwiek zmian w środowisku produkcyjnym zapoznaj się z zaletami i wadami jednoczesnego korzystania z AOF i RDB.
</Info>

Więcej informacji o włączaniu trwałości AOF w Redis znajdziesz tutaj: [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](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. Zaplanuj okno serwisowe na potrzeby aktualizacji.
2. Zatrzymaj instancję za pomocą `bin/stop` i wykonaj kopię zapasową katalogów <strong>config/</strong> i <strong>data/</strong>.
3. Uruchom `bin/up`, aby wystartować instancję
4. Uruchom polecenie `docker exec -it redis sh`
5. Uruchom polecenie `redis-cli`, aby otworzyć interfejs wiersza poleceń Redis
6. W redis-cli uruchom polecenie `config set appendonly yes`
7. Teraz musisz poczekać, aż przepisywanie AOF zakończy utrwalanie danych. Możesz to zrobić, wpisując `INFO persistence` w redis-cli i czekając, aż `aof_rewrite_in_progress` oraz `aof_rewrite_scheduled` przyjmą wartość `0`, a następnie sprawdzając, czy `aof_last_bgrewrite_status` ma wartość `ok`.
8. Wyjdź z redis-cli, wpisując `exit` i naciskając klawisz Enter
9. Wyjdź z kontenera redis, wpisując `exit` i naciskając klawisz Enter
10. Uruchom polecenie `ls ./data/redis` i upewnij się, że widzisz plik **appendonly.aof**
11. Edytuj plik **config/overleaf.rc** i zmień wartość zmiennej środowiskowej `REDIS_AOF_PERSISTENCE` z `false` na `true`
12. Uruchom `bin/up -d` i upewnij się, że aplikacja działa (edytor projektów i panel historii funkcjonują poprawnie).


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