> 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/zh-tw/an-zhuang/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 %}

### 編輯變數檔案

開啟 `config/variables.env` ，並在您喜歡的文字編輯器中，將下方環境變數更新為所需的值。
{% endstep %}

{% step %}

### 必要的環境變數

請在以下位置更新變數 `config/variables.env`:

| 名稱                            | 描述                                                                   | 範例                              |
| ----------------------------- | -------------------------------------------------------------------- | ------------------------------- |
| `OVERLEAF_SITE_URL`           | 您的 Overleaf 執行個體公開可存取的位置。這會用於公開連結，以及透過 websockets 連線時，因此 **必須正確設定**! | `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 %}

如果一切順利，您應該可以透過前往 <http://127.0.0.1/> 或 <http://localhost/> 在您的瀏覽器中查看新 Overleaf 執行個體的登入頁面。

{% 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/zh-tw/an-zhuang/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.