> 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/ko/configuration/overleaf-toolkit/redis.md).

# Redis

### 비밀번호 인증 활성화

외부 Redis 서비스를 사용 중이고 비밀번호를 제공해야 한다면, `OVERLEAF_REDIS_PASS` 그리고 `REDIS_PASSWORD` 환경 변수를 **config/variables.env** 파일에 `bin/up -d` 명령을 실행하여 **sharelatex** 컨테이너.

로컬 Redis 인스턴스를 실행 중이라면, **redis** 서비스가 비밀번호 인증으로 시작되도록 구성해야 합니다. 위의 환경 변수를 설정한 후에는 다음 추가 단계도 완료해야 합니다:

다음을 생성하세요 **docker-compose.override.yml** 파일을 **config/** 디렉터리에 다음 내용을 넣어 생성하세요:

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

```yaml
services:
    redis:
        명령: "redis-server --requirepass <YOUR-PASSWORD>"
```

{% endcode %}

{% hint style="warning" %}
AOF 지속성을 사용 중이라면, `--appendonly yes` 에 `명령`.
{% endhint %}

실행하세요 `bin/up -d` 컨테이너를 다시 생성하려면.

### 추가 전용 파일 지속성 활성화

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

Redis AOF(추가 전용 파일) 지속성은 서버가 받은 모든 쓰기 작업을 기록하여 데이터 내구성을 보장하는 강력한 방법을 제공합니다. 데이터셋의 시점 복사본을 만드는 RDB 스냅샷과 달리, AOF는 데이터에 대해 수행된 모든 변경 사항의 완전한 기록을 유지합니다.

{% hint style="info" %}
RDB 비활성화는 선택 사항입니다. 일반적으로는 두 지속성 방식을 함께 사용하는 것이 권장됩니다. 프로덕션에서 변경하기 전에 AOF와 RDB를 함께 실행할 때의 장단점을 검토하세요.
{% endhint %}

Redis에서 AOF 지속성을 활성화하는 방법에 대해 더 알아보려면 여기에서 읽어보세요: <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. 업그레이드를 위한 유지보수 시간을 잡으세요.
2. 를 사용하여 인스턴스를 중지하고 `bin/stop` 와 **config/** 그리고 **data/** 폴더의 백업을 만드세요.
3. 실행하세요 `bin/up` 인스턴스를 시작하려면
4. 다음 명령을 실행하세요 `docker exec -it redis sh`
5. 다음 명령을 실행하세요 `redis-cli` Redis 명령줄 인터페이스를 열려면
6. redis-cli에서 다음 명령을 실행하세요 `config set appendonly yes`
7. 이제 AOF 다시 쓰기가 데이터 지속 저장을 마칠 때까지 기다려야 합니다. 다음을 입력하면 됩니다 `INFO persistence` 를 redis-cli에 입력한 뒤 다음이 `aof_rewrite_in_progress` 그리고 `aof_rewrite_scheduled` 가 `0`이고, 다음이 `aof_last_bgrewrite_status` 가 `ok`.
8. redis-cli를 종료하려면 다음을 입력하세요 `exit` 한 다음 Enter 키를 누르세요
9. 다음을 입력하여 redis 컨테이너를 종료하세요 `exit` 한 다음 Enter 키를 누르세요
10. 다음 명령을 실행하세요 `ls ./data/redis` 를 실행하고 다음을 볼 수 있는지 확인하세요 **appendonly.aof** 파일
11. 수정하세요 **config/overleaf.rc** 파일을 확인하고 `REDIS_AOF_PERSISTENCE` 환경 변수를 다음에서 `false` 에서 `true`
12. 실행하세요 `bin/up -d` 그리고 애플리케이션이 정상 작동하는지 확인하세요(프로젝트 편집기와 기록 패널이 작동합니다).


---

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