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

# 문제 해결

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

<details>

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

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

컴파일에서 흔히 보이는 오류 하나는 다음과 같습니다:

```
EBUSY: resource busy or locked, 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` 명령으로 로그 사본을 출력하세요.

다음 줄이 보이면 `Fatal: Can't initialize 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 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis가 시작 중입니다 oO0OoO0OoO0Oo
```

{% 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 찾기인스턴스의 템플릿 갤러리 (/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` 명령은 모든 컴파일이 동일한 `sharelatex` 컨테이너 안에서 이루어지므로 Community Edition에서는 기본적으로 비활성화되어 있습니다. 이것이 더 안전한 기본값입니다.

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://ayakaleaf-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.