> 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/support/getting-help.md).

# 도움 받기

### 닥터

Overleaf Toolkit에는 유용한 `doctor` 디버깅에 도움이 되는 스크립트가 있습니다. 실행하세요 `bin/doctor` 그러면 스크립트가 호스트 환경, 구성, 그리고 Toolkit에 필요한 종속성에 대한 정보를 출력합니다. 이 출력은 Overleaf 지원 팀이 Server Pro 설치의 문제를 진단하는 데도 도움이 될 수 있습니다.

{% hint style="info" %}
Overleaf Pro 사용자는 [GitHub에 이슈를 열 수 있습니다](https://github.com/ayaka-notes/overleaf/issues).

메시지에 `bin/doctor` 스크립트의 출력을 포함하는 것이 좋습니다.
{% endhint %}

### 닥터와 상담하기 <a href="#consulting-with-the-doctor" id="consulting-with-the-doctor"></a>

doctor 스크립트를 실행하세요:

{% code title="doctor 실행" %}

```bash
bin/doctor
```

{% endcode %}

아래 예와 비슷한 출력이 표시됩니다.

<details>

<summary>전체 예시 출력</summary>

```
====== 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 데몬
    - 상태: 실행 중
====== Configuration ======
- 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

====== Warnings ======
- 없음, 모두 양호
====== End ======
```

</details>

### 호스트 정보

해당 `호스트 정보` 이 섹션에는 Toolkit을 실행하는 머신에 대한 정보가 포함됩니다(예: Linux 배포판 및 릴리스).

<details>

<summary>호스트 정보 예시 출력</summary>

```
- 호스트 정보
    - Linux
    - 'lsb_release -a' 출력:
            사용 가능한 LSB 모듈이 없습니다.
            배포판 ID:	Ubuntu
            설명:	Ubuntu 22.04.5 LTS
            릴리스:	22.04
            코드명:	jammy
```

</details>

### 종속성

해당 `종속성` 이 섹션에는 Toolkit이 작동하는 데 필요한 도구가 나열됩니다. 도구가 있으면 다음과 같이 표시됩니다 `상태: 있음` 버전 정보와 함께. 없으면 다음과 같이 표시됩니다 `상태: 누락됨!` 그리고 경고가 다음의 하단에 추가됩니다 `doctor` 출력.

<details>

<summary>종속성 예시 출력(있음)</summary>

```
- docker
    - 상태: 있음
    - 버전 정보: Docker version 28.0.4, build b8034c0
```

</details>

<details>

<summary>종속성 예시 출력(없음)</summary>

```
- docker
    - 상태: 누락됨!
```

</details>

종속성이 하나라도 없으면 Toolkit은 거의 확실히 작동하지 않습니다.

### 구성

해당 `구성` 이 섹션에는 다음에 있는 파일에 대한 정보가 포함됩니다 `config/` 디렉터리에 대한 정보가 포함됩니다. 다음의 경우 `config/overleaf.rc`doctor는 몇 가지 주요 값을 출력합니다. 누락된 파일은 다음과 같이 표시됩니다 `상태: 누락됨!` 그리고 경고가 다음의 하단에 추가됩니다 `doctor` 출력.

<details>

<summary>구성 예시 출력</summary>

```
====== Configuration ======
- 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
    - 상태: 누락됨!
```

</details>

위 예시에서 참고할 점:

* `OVERLEAF_DATA_PATH` 를 `/tmp/overleaf` 중요한 데이터를 저장하기에 안전한 위치가 아닐 수 있습니다.
* `MONGO_ENABLED: false` 는 Toolkit이 자체 MongoDB를 프로비저닝하지 않음을 의미합니다. 필요하다면 `MONGO_URL` 가 외부에서 관리되는 MongoDB를 가리키도록 하세요.
* `config/variables.env` 예시에서 누락되어 있습니다.

### 경고

해당 `경고` 이 섹션에는 doctor 스크립트가 발견한 문제들이 요약됩니다. 문제가 없으면 이 섹션에 그 점이 표시됩니다.

<details>

<summary>경고 예시 출력</summary>

```
====== Warnings ======
- 구성 파일 variables.env를 찾을 수 없음
- rc 파일, OVERLEAF_DATA_PATH가 설정되지 않음
====== 끝 =======
```

</details>


---

# 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/support/getting-help.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.
