> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ko/installation/using-the-toolkit/5.-personalizing-your-instance.md).

# 5. 인스턴스 개인 설정하기

### 인스턴스 개인 설정 <a href="#personalizing-your-instance" id="personalizing-your-instance"></a>

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

{% stepper %}
{% step %}

### variables 파일을 편집하세요

열기 `config/variables.env` 좋아하는 텍스트 편집기에서 아래 환경 변수를 필요한 값으로 업데이트하세요.
{% endstep %}

{% step %}

### 필수 환경 변수

다음 변수를 `config/variables.env`:

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

이 환경 변수들을 업데이트한 후 저장하고 종료하세요.
{% endstep %}

{% step %}

### 인스턴스 시작

인스턴스를 시작하려면 다음을 실행하세요:

{% code title="인스턴스 시작" %}

```
bin/up
```

{% endcode %}

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

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

{% code title="로그에 연결하지 않고 시작" %}

```
bin/start
```

{% endcode %}
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Toolkit은 `docker compose` 를 사용하여 Overleaf Docker 컨테이너를 관리합니다. Toolkit은 `docker compose` 를 감싸고 대부분의 세부 사항을 처리하는 스크립트 모음을 제공합니다.
{% endhint %}

모든 것이 잘 진행되면, 다음으로 이동하여 새 Overleaf 인스턴스의 로그인 페이지를 볼 수 있어야 합니다: <http://127.0.0.1/> 또는 <http://localhost/> 를 브라우저에서 열어보세요.

{% hint style="warning" %}
네트워크 구성과 Overleaf 인스턴스가 호스팅되는 위치에 따라 추가 구성 변경이 필요할 수 있습니다. 자세한 내용은 Toolkit 설정을 참조하세요:

<https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/toolkit-settings>
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ko/installation/using-the-toolkit/5.-personalizing-your-instance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.