> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

<Info>
  이전 버전을 사용 중이라면 경로 이름에서 `overleaf` 대신 `sharelatex`를 사용하세요.
</Info>

<Accordion title="NFS 파일 시스템에서 Overleaf 실행하기">
  Overleaf 컨테이너에 NFS 파일 시스템을 마운트하는 것은 기술적으로 가능하지만 권장하지 않으며, 다양한 유형의 성능 오류가 발생할 수 있습니다.

  컴파일 시 흔히 발생하는 오류는 다음과 같습니다.

  ```text theme={null}
  EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
  ```

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

  `docker-compose` 기반 구성의 경우, 애플리케이션의 경로를 변경하지 않도록 NFS에서의 바인드 마운트를 재정의하는 방법을 권장합니다. 다음은 `/scratch`에 마운트된 스크래치 디스크를 사용하는 `docker-compose` 구성 발췌 예시입니다.

  ```yaml title="docker-compose excerpt" theme={null}
  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
  ```

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

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

<Accordion title="Windows 또는 macOS에서 Overleaf를 실행하면 `mongo` 서비스가 시작되지 않는 문제">
  Windows 또는 macOS에서 Overleaf를 실행하는 경우, `mongo` 서비스가 다음 오류와 함께 재시작에 실패할 수 있습니다.

  ```text title="Example error" theme={null}
  Failed to start up WiredTiger under any compatibility version.
  Reason: 1: Operation not permitted
  ```

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

  ```yaml title="config/docker-compose.override.yml" theme={null}
  volumes:
    mongo-data:
    redis-data:

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

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

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

<Accordion title="Redis 6.2로 업그레이드하면 재시작 루프가 발생하는 문제">
  `docker logs redis` 명령을 사용하여 로그 사본을 출력하세요.

  `Fatal: Can't initialize Background Jobs` 줄이 보인다면 전체 출력은 다음과 비슷할 것입니다.

  ```text title="Redis log example" theme={null}
  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 is starting oO0OoO0OoO0Oo
  ```

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

  자세한 내용은 Redis 업스트림 이슈를 참고하세요: [https://github.com/redis/redis/issues/12362](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](https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop)
</Accordion>

<Accordion title="템플릿 갤러리 미리보기/썸네일 이미지 방향이 잘못된 문제">
  간혹 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](https://your-instance-url/templates/6645d346c224815e9460a695)). 수정 명령 실행: Docker 호스트에서 다음 명령을 실행합니다(템플릿 ID를 복사한 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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="시스템 호출이 활성화되어 있는지 확인하세요. pdflatex의 경우 'pdflatex -shell-escape'입니다.">
  Community Edition에서는 모든 컴파일이 동일한 `sharelatex` 컨테이너 안에서 이루어지기 때문에 `\write18` 명령이 기본적으로 비활성화되어 있습니다. 이것이 더 안전한 기본값입니다.

  pdflatex에서 이를 활성화하려면 프로젝트 루트에 다음 내용으로 `latexmkrc` 파일을 만드세요.

  ```perl title="latexmkrc" theme={null}
  $pdflatex = 'pdflatex --shell-escape';
  ```

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.