초기화가 invalid command code로 실패합니다
bin/init은 macOS의 BSD sed를 발견하면 sed: ... invalid command code를 보고합니다. 1. Toolkit 다운로드에 설명된 대로 GNU sed를 PATH에 추가하고 sed --version을 확인하세요.
초기화에 실패하면 config/에 세 파일이 모두 남으면서 OVERLEAF_INVITE_TOKEN_SECRET이 비어 있을 수 있습니다. 그 후 bin/init을 다시 실행하면 Config files already exist가 표시됩니다. 한 번도 시작한 적이 없는 새 설치라면 세 파일을 백업 디렉터리로 옮기고 bin/init을 다시 실행하세요. 기존 인스턴스라면 구성과 비밀 값을 유지하고, bin/init을 다시 실행하기 위해 파일을 삭제하지 마세요.
MongoDB가 계속 재시작됩니다
MongoDB 로그와 Docker VM의 커널 버전을 확인하세요.bin/up -d를 다시 실행하세요. 종료 코드 137만으로는 MongoDB의 메모리가 부족했다는 것이 증명되지 않습니다. 컨테이너 상태와 로그를 확인하세요. Docker Desktop의 오래된 MongoDB 문제에 대해서는 문제 해결도 참조하세요.
Docker 데몬에 연결할 수 없습니다
Docker Desktop을 시작하고 선택된 Docker 컨텍스트를 확인하세요. 0. Docker Desktop 설정을 참조하세요.docker info는 작동하지만 컴파일이 Docker에 접근하지 못한다면 config/overleaf.rc의 소켓 설정을 확인하고 clsi 로그를 읽어 보세요. Mac에서 Docker CLI가 작동한다고 해서 애플리케이션의 소켓 마운트가 올바르다는 것이 증명되지는 않습니다.
페이지는 열리지만 컴파일이 실패합니다
TeX Live 이미지가 로컬에 있고 Docker 엔진의 아키텍처와 일치하는지 확인하세요.linux/arm64여야 합니다. SERVER_PRO와 SIBLING_CONTAINERS_ENABLED가 모두 true인지 확인한 다음 bin/up -d로 변경 사항을 적용하세요. 로그에 컴파일 디렉터리가 없다고 표시되면 Docker Desktop의 파일 공유와 OVERLEAF_DATA_PATH 위치를 확인하세요. 마운트 실패를 숨기기 위해 Sandboxed Compiles를 끄지 마세요.
Not a directory 오류가 나거나 바인드 마운트가 없습니다
오버라이드가 마운트하는 호스트 파일이 삭제되었거나, 파일이 있어야 할 위치에 Docker가 디렉터리를 만들었을 수 있습니다. 호스트의 소스 경로를 확인하고, 마운트가 파일을 기대하는지 디렉터리를 기대하는지 확인하세요. 컨테이너를 다시 만들기 전에 구성 파일을 복원하세요./tmp 아래에 설치한 경우 macOS가 임시 파일을 제거한 후 이 문제가 발생할 수 있습니다.
포트 또는 컨테이너 이름 충돌
포트8080이 사용 중이라면 config/overleaf.rc에서 다른 포트를 선택하고, OVERLEAF_SITE_URL도 그에 맞게 설정한 다음 bin/up -d를 다시 실행하세요.
Toolkit은 컨테이너에 sharelatex, mongo, redis 같은 고정된 이름을 부여합니다. PROJECT_NAME만 변경해서는 두 Toolkit 설치가 서로 독립되지 않습니다. 두 번째 인스턴스를 시작하기 전에 docker ps -a를 확인하고, Compose 오버라이드에서 다른 컨테이너 이름, 다른 포트, 별도의 데이터 디렉터리를 사용하세요. 이름 충돌을 해결하기 위해 기존 배포의 컨테이너나 데이터를 제거하지 마세요.