5. 인스턴스 개인화

​

인스턴스 개인화

Overleaf 인스턴스를 처음 시작하기 전에 config/variables.env 구성 파일을 사용자 정보로 업데이트하세요.

1. 변수 파일 편집

   선호하는 텍스트 편집기에서 config/variables.env를 열고 아래 환경 변수를 필요한 값으로 업데이트합니다.

2. 필수 환경 변수

   config/variables.env에서 다음 변수를 업데이트합니다.

   이름	설명	예시
   OVERLEAF_SITE_URL	Overleaf 인스턴스가 공개적으로 제공되는 주소입니다. 공개 링크와 웹소켓 연결에 사용되므로 반드시 올바르게 구성해야 합니다!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	이 이메일 주소는 모든 발신 이메일의 from 주소로 사용됩니다.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	사용자가 사이트 운영자에게 연락할 수 있는 이메일 주소입니다.	[e-mail]

   이 환경 변수를 업데이트했으면 저장하고 종료합니다.

3. 샌드박스 컴파일 설정

   다음으로 sandboxed-compiles.md를 위해 TeX Live Full을 구성합니다. config/variables.env를 열고 다음 환경 변수를 업데이트합니다.

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. 인스턴스 시작

   인스턴스를 시작하려면 다음을 실행합니다.

   Start the instance

   bin/up
   

   이 명령은 texlive를 포함한 필요한 이미지를 다운로드하고, (사용자 지정 설정을 사용하여) 컨테이너를 생성한 다음 인스턴스를 시작합니다. 여러 Docker 컨테이너의 로그 출력이 표시됩니다.

   나중에 (로그 출력에 연결하지 않고) 다시 시작하려면 다음을 실행합니다.

   Start without attaching to logs

   bin/start
   

Toolkit은 docker compose를 사용하여 Overleaf Docker 컨테이너를 관리합니다. Toolkit은 docker compose를 감싸는 스크립트 모음을 제공하여 대부분의 세부 사항을 대신 처리해 줍니다.

모든 것이 순조롭게 진행되면 브라우저에서 http://127.0.0.1/ 또는 http://localhost/로 이동하여 새 Overleaf 인스턴스의 로그인 페이지를 볼 수 있습니다.

네트워크 구성과 Overleaf 인스턴스가 호스팅되는 위치에 따라 추가 구성 변경이 필요할 수 있습니다. 자세한 내용은 Toolkit 설정을 참고하세요: toolkit-settings.md