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

# 문제 해결

{% hint style="info" %}
이전 버전을 사용 중이라면 다음을 사용하세요 `sharelatex` 대신에 `overleaf` 를 경로 이름에.
{% endhint %}

<details>

<summary>NFS 파일 시스템으로 Overleaf 실행</summary>

Overleaf 컨테이너에 NFS 파일 시스템을 마운트하는 것은 기술적으로 가능하지만 권장되지 않으며, 여러 유형의 성능 오류를 초래할 수 있습니다.

컴파일에서 흔히 볼 수 있는 오류 중 하나는 다음과 같습니다:

```
EBUSY: 리소스 사용 중이거나 잠겨 있음, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

특히 컴파일 데이터에 사용되는 디렉터리처럼 일시적인 데이터에는 NFS 기반 파일 시스템 사용을 권장하지 않습니다. 다음 디렉터리에는 로컬 스크래치 디스크, 가능하면 로컬 SSD를 사용하는 것을 권장합니다.

다음의 경우 `docker-compose` 기반 설정에서는, 애플리케이션의 경로를 변경하지 않도록 NFS에서 바인드 마운트를 덮어쓰는 것만을 권장합니다. 다음은 예시입니다. `docker-compose` 스크래치 디스크를 사용하는 구성 일부로, 다음에 마운트됩니다. `/scratch`:

{% code title="docker-compose 일부" %}

```yaml
services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp
```

{% endcode %}

업데이트 후 NFS의 기존 파일을 새 위치로 이전할 필요는 없습니다. LaTeX 컴파일러는 전체 컴파일을 다시 실행하면 모든 파일을 재생성할 수 있습니다.

자세한 내용은 다음을 참조하세요: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Windows 또는 macOS에서 Overleaf를 실행하면 `mongo` 서비스가 시작되지 않음</summary>

Windows 또는 macOS에서 Overleaf를 실행 중이라면, `mongo` 서비스가 다시 시작되지 않을 수 있으며, 다음과 같은 오류가 발생합니다:

{% code title="오류 예시" %}

```
어떤 호환성 버전에서도 WiredTiger를 시작하지 못했습니다.
이유: 1: 작업이 허용되지 않음
```

{% endcode %}

이 오류를 피하려면 데이터를 바인드 마운트된 디렉터리가 아니라 볼륨에 저장해야 합니다(자세한 내용은 `mongo` 이미지 문서를 참조하세요: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). MongoDB 및 Redis 컨테이너 안에 마운트된 Docker 볼륨에 데이터를 저장하려면 다음을 `config/docker-compose.override.yml` (아직 이 파일이 없다면 생성하세요):

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

```yaml
volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

자세한 내용은 다음을 참조하세요: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Redis 6.2로 업그레이드하면 재시작 루프가 발생함</summary>

다음을 사용하세요. `docker logs redis` 명령어로 로그 사본을 출력합니다.

다음 줄이 보이면 `치명적 오류: Background Jobs를 초기화할 수 없음`, 전체 출력은 대략 다음과 같습니다:

{% code title="Redis 로그 예시" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # 치명적 오류: Background Jobs를 초기화할 수 없습니다.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0OoO0Oo
```

{% endcode %}

현재 사용 중인 Docker 버전과 관련이 있을 수 있습니다. 20.10.10 이상으로 업데이트하면 이 문제를 해결할 수 있습니다.

자세한 내용은 Redis 상류 이슈를 참조하세요: <https://github.com/redis/redis/issues/12362>

참조: <https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop>

</details>

<details>

<summary>템플릿 갤러리 미리보기/썸네일 이미지의 잘못된 방향</summary>

때때로 Server Pro가 생성한 미리보기/썸네일 이미지가 잘못된 방향으로 생성되어 수정하려면 수동 조치가 필요할 수 있습니다. 이러한 이미지는 다음에 저장됩니다. `/var/lib/overleaf/data/template_files/` (>= 5.0.3) 및 `/var/lib/sharelatex/data/template_files/` (이전 버전).

변경을 가하기 전에 이 폴더를 백업하는 것을 권장합니다.

영향을 받는 각 템플릿에 대해 아래 단계를 따라야 합니다:

템플릿 ID를 찾습니다Overleaf 인스턴스의 템플릿 갤러리(/templates/all)로 이동하여 영향을 받는 템플릿을 열고 URL에서 ID를 복사합니다(예: <https://your-instance-url/templates/6645d346c224815e9460a695).수정> 명령을 실행합니다다음 명령을 Docker 호스트에서 실행하세요(복사한 템플릿 ID로 바꾸고 필요하면 경로도 업데이트하세요):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

참조: <https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images>

</details>

<details>

<summary>시스템 호출이 활성화되어 있는지 확인하세요. pdflatex의 경우 이는 'pdflatex -shell-escape'입니다.</summary>

해당 `\write18` 명령은 Community Edition에서 기본적으로 비활성화되어 있습니다. 모든 컴파일이 동일한 `sharelatex` 컨테이너에서 이루어지기 때문입니다. 이것이 더 안전한 기본 설정입니다.

pdflatex에 대해 이를 활성화하려면 `latexmkrc` 파일을 프로젝트 루트에 다음 내용으로 생성하세요:

{% code title="latexmkrc" %}

```perl
$pdflatex = 'pdflatex --shell-escape';
```

{% endcode %}

그다음 다시 컴파일해 보세요.

참조: <https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape>

</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/troubleshooting.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.