> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/ko/support/getting-help.md).
# 도움 받기
### Doctor
Overleaf Toolkit에는 편리한 `doctor` 스크립트가 포함되어 있어 디버깅에 도움이 됩니다. 다음을 실행하세요: `bin/doctor` 그러면 이 스크립트가 호스트 환경, 구성, 그리고 Toolkit에 필요한 종속성에 대한 정보를 출력합니다. 이 출력은 Server Pro 설치에서 Overleaf 지원팀이 문제를 진단하는 데에도 도움이 될 수 있습니다.
{% hint style="info" %}
Overleaf Pro 사용자는 [GitHub에서 이슈를 열 수 있습니다](https://github.com/ayaka-notes/overleaf/issues).
메시지에 `bin/doctor` 스크립트의 출력 내용을 포함하는 것이 좋습니다.
{% endhint %}
### Doctor와 함께 살펴보기
doctor 스크립트를 실행하세요:
{% code title="doctor 실행" %}
```bash
bin/doctor
```
{% endcode %}
아래 예시와 비슷한 출력이 표시됩니다.
전체 출력 예시
```
====== Overleaf Doctor ======
- 호스트 정보
- Linux
- 'lsb_release -a' 출력:
LSB 모듈을 사용할 수 없습니다.
배포판 ID: Ubuntu
설명: Ubuntu 22.04.5 LTS
릴리스: 22.04
코드명: jammy
- 종속 항목
- bash
- 상태: 있음
- 버전 정보: 5.1.16(1)-release
- docker
- 상태: 있음
- 버전 정보: Docker version 28.0.4, build b8034c0
- docker compose
- 상태: 있음
- 버전 정보: Docker Compose version v2.34.0
- realpath
- 상태: 있음
- 버전 정보: realpath (GNU coreutils) 8.32
- perl
- 상태: 있음
- 버전 정보: 5.034000
- awk
- 상태: 있음
- 버전 정보: mawk 1.3.4 20200120
- Docker 데몬
- 상태: 실행 중
====== 구성 ======
- config/version
- 상태: 있음
- 버전: 5.4.0
- config/overleaf.rc
- 상태: 있음
- 값
- OVERLEAF_DATA_PATH: data/overleaf
- OVERLEAF_LOG_PATH: data/overleaf/logs
- SERVER_PRO: true
- SIBLING_CONTAINERS_ENABLED: true
- quay.io에 로그인됨: true
- MONGO_ENABLED: true
- REDIS_ENABLED: true
- config/variables.env
- 상태: 있음
- 값
- OVERLEAF_FILESTORE_BACKEND: fs
- OVERLEAF_HISTORY_BACKEND: fs
====== 경고 ======
- 없음, 모두 정상
====== 끝 ======
```
### 호스트 정보
다음 `호스트 정보` 섹션에는 Toolkit이 실행 중인 머신에 대한 정보(예: Linux 배포판 및 릴리스)가 포함됩니다.
호스트 정보 출력 예시
```
- 호스트 정보
- Linux
- 'lsb_release -a' 출력:
LSB 모듈을 사용할 수 없습니다.
배포판 ID: Ubuntu
설명: Ubuntu 22.04.5 LTS
릴리스: 22.04
코드명: jammy
```
### 종속성
다음 `종속성` 섹션에는 Toolkit이 작동하는 데 필요한 도구 목록이 표시됩니다. 도구가 있으면 다음과 같이 표시됩니다. `상태: 존재함` 및 버전 정보와 함께 표시됩니다. 없으면 다음과 같이 표시됩니다. `상태: 누락됨!` 그리고 경고가 `doctor` 출력 하단에 추가됩니다.
종속성 출력 예시(존재함)
```
- docker
- 상태: 있음
- 버전 정보: Docker version 28.0.4, build b8034c0
```
종속성 출력 예시(누락됨)
```
- docker
- 상태: 누락됨!
```
종속성이 하나라도 누락되면 Toolkit은 거의 확실하게 작동하지 않습니다.
### 설정
다음 `설정` 섹션에는 `config/` 디렉터리의 파일에 대한 정보가 포함됩니다. `config/overleaf.rc`의 경우 doctor가 몇 가지 핵심 값을 출력합니다. 누락된 파일은 다음과 같이 표시됩니다. `상태: 누락됨!` 그리고 경고가 `doctor` 출력 하단에 추가됩니다.
구성 출력 예시
```
====== 구성 ======
- config/version
- 상태: 있음
- 버전: 5.4.0
- config/overleaf.rc
- 상태: 있음
- 값
- OVERLEAF_DATA_PATH: /tmp/overleaf
- SERVER_PRO: false
- MONGO_ENABLED: false
- REDIS_ENABLED: true
- config/variables.env
- 상태: 누락됨!
```
위 예시의 참고 사항:
* `OVERLEAF_DATA_PATH` 를 `/tmp/overleaf` 는 중요한 데이터를 저장하기에 안전한 위치가 아닐 수 있습니다.
* `MONGO_ENABLED: false` 는 Toolkit이 자체 MongoDB를 프로비저닝하지 않음을 의미합니다. 필요하다면 `MONGO_URL` 가 외부에서 관리되는 MongoDB를 가리키는지 확인하세요.
* `config/variables.env` 는 예시에서 누락되었습니다.
### 경고
다음 `경고` 섹션에는 doctor 스크립트가 발견한 문제 요약이 표시됩니다. 문제가 없으면 이 섹션에 그 사실이 표시됩니다.
경고 출력 예시
```
====== 경고 ======
- 구성 파일 variables.env를 찾을 수 없음
- rc 파일, OVERLEAF_DATA_PATH가 설정되지 않음
====== 끝 =======
```
---
# 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://ayakaleaf-pro.ayaka.space/on-premises/ko/support/getting-help.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.