> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 執行個體可公開存取的位置。這會用於公開連結，以及透過 WebSocket 連線時，因此 **必須正確設定**! | `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://ayakaleaf-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.