> ## 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.

# 5. 인스턴스 개인화

### 인스턴스 개인화

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

<Steps>
  <Step title="변수 파일 편집">
    선호하는 텍스트 편집기에서 `config/variables.env`를 열고 아래 환경 변수를 필요한 값으로 업데이트합니다.
  </Step>

  <Step title="필수 환경 변수">
    `config/variables.env`에서 다음 변수를 업데이트합니다.

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

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

  <Step title="샌드박스 컴파일 설정">
    다음으로 [sandboxed-compiles.md](/ko/on-premises/configuration/overleaf-toolkit/sandboxed-compiles "mention")를 위해 TeX Live Full을 구성합니다. `config/variables.env`를 열고 다음 환경 변수를 업데이트합니다.

    ```dotenv title="config/variables.env" wrap theme={null}
    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
    ```
  </Step>

  <Step title="인스턴스 시작">
    인스턴스를 시작하려면 다음을 실행합니다.

    ```text title="Start the instance" theme={null}
    bin/up
    ```

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

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

    ```text title="Start without attaching to logs" theme={null}
    bin/start
    ```
  </Step>
</Steps>

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

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

<Warning>
  네트워크 구성과 Overleaf 인스턴스가 호스팅되는 위치에 따라 추가 구성 변경이 필요할 수 있습니다. 자세한 내용은 Toolkit 설정을 참고하세요: [toolkit-settings.md](/ko/on-premises/configuration/overleaf-toolkit/toolkit-settings "mention")
</Warning>


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