5. 인스턴스 개인화

Mac의 로컬 인스턴스에 대한 포트, 사이트 URL, TeX Live 이미지를 설정하고, Docker VM 커널을 확인한 다음 Ayakaleaf Pro를 시작합니다.

1. 컨테이너 설정

   config/overleaf.rc에서 다음 기존 항목을 수정하세요.

   config/overleaf.rc

   PROJECT_NAME=ayakaleaf-macos
   SERVER_PRO=true
   OVERLEAF_LISTEN_IP=127.0.0.1
   OVERLEAF_PORT=8080
   SIBLING_CONTAINERS_ENABLED=true
   DOCKER_SOCKET_PATH=/var/run/docker.sock
   

   기본 데이터 경로와 번들된 MongoDB 및 Redis 서비스는 그대로 유지하세요. OVERLEAF_LISTEN_IP=127.0.0.1이면 이 Mac의 브라우저에서만 인스턴스를 열 수 있습니다.

2. 애플리케이션 설정

   config/variables.env에서 다음 값을 설정하고, 같은 이름의 활성 항목이 있다면 교체하세요.

   config/variables.env

   OVERLEAF_SITE_URL=http://localhost:8080
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
   

   세션 비밀 값을 생성하세요.

   openssl rand -hex 32
   

   결과를 config/variables.env에 OVERLEAF_SESSION_SECRET으로 추가하세요. 이 값이 없으면 컨테이너를 다시 만드는 bin/up을 실행할 때마다 모든 사용자가 로그아웃됩니다. 환경 변수를 참조하세요.

   이메일이 없는 로컬 인스턴스라면 SMTP 설정과 OVERLEAF_EMAIL_FROM_ADDRESS는 설정하지 않은 채로 두세요. Git Bridge, 외부 인증 및 기타 통합은 나중에 각각의 구성 페이지에 따라 추가할 수 있습니다.

3. Docker VM의 Linux 커널 확인

   MongoDB는 macOS가 아니라 Docker Desktop 가상 머신의 Linux 커널에서 실행됩니다. 처음 시작하기 전에 커널 버전을 확인하세요.

   docker info --format '{{.KernelVersion}}'
   

   MongoDB는 Linux 커널 6.19부터 7.0.13까지와의 비호환성을 문서화하고 있으며, 이는 Docker의 MongoDB에도 영향을 줍니다. 해결책은 커널 7.0.14 이상이며, Docker Desktop 업데이트와 함께 제공됩니다. MongoDB의 프로덕션 노트를 참조하세요.

   Docker VM이 영향을 받는 커널을 사용한다면 config/docker-compose.override.yml에 다음을 추가하고, 이미 있는 services와 병합하세요.

   config/docker-compose.override.yml

   services:
     mongo:
       environment:
         GLIBC_TUNABLES: glibc.pthread.rseq=1
   

   수정된 커널이 제공되면 업데이트하세요. 커널이 영향을 받는 범위 밖에 있다면 이 해결 방법은 필요하지 않습니다.

4. 인스턴스 시작

   Toolkit 디렉터리에서 다음을 실행하세요.

   bin/up -d
   

   Toolkit은 MongoDB의 복제본 세트를 초기화하고, TeX Live 이미지를 가져오고, 애플리케이션을 시작합니다. 첫 다운로드에는 시간이 걸립니다. 진행 상황을 확인하려면 다음을 실행하세요.

   bin/docker-compose ps
   bin/docker-compose logs --tail=100 -f sharelatex
   

   로그 확인을 멈추려면 Ctrl+C를 누르세요. 컨테이너는 계속 실행됩니다.

   게시된 포트와 첫 실행 페이지를 확인하세요.

   bin/docker-compose port sharelatex 80
   curl -I http://localhost:8080/launchpad
   

   포트는 127.0.0.1:8080이어야 합니다.

나중에 다른 컴퓨터에서 인스턴스를 열려면 Linux 가이드의 5. 인스턴스 개인화에 설명된 대로 수신 주소와 사이트 URL을 변경하고 HTTPS를 설정하세요. 그러면 Mac이 잠자기 상태가 되지 않아야 합니다. 인스턴스 가용성 유지를 참조하세요.

​

다음 단계

6. 설치 후 작업으로 계속 진행하세요.