> 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-cn/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://ayakaleaf-pro.ayaka.space/on-premises/zh-cn/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.