> 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/vi/cai-dat/using-the-toolkit/5.-personalizing-your-instance.md).

# 5. Tùy chỉnh phiên bản của bạn

### Cá nhân hóa phiên bản của bạn <a href="#personalizing-your-instance" id="personalizing-your-instance"></a>

Trước khi bạn khởi động phiên bản Overleaf của mình lần đầu tiên, hãy cập nhật `config/variables.env` tệp cấu hình với thông tin tùy chỉnh của bạn.

{% stepper %}
{% step %}

### Chỉnh sửa tệp biến

Mở `config/variables.env` trong trình soạn thảo văn bản bạn yêu thích và cập nhật các biến môi trường dưới đây với các giá trị bắt buộc.
{% endstep %}

{% step %}

### Các biến môi trường bắt buộc

Cập nhật các biến sau trong `config/variables.env`:

| Tên                           | Mô tả                                                                                                                                                              | Ví dụ                           |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
| `OVERLEAF_SITE_URL`           | Nơi phiên bản Overleaf của bạn có sẵn công khai. Điều này được dùng trong các liên kết công khai và khi kết nối qua websocket, vì vậy **phải được cấu hình đúng**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | Địa chỉ email này sẽ được dùng làm `người gửi` cho tất cả email gửi đi.                                                                                            | `no-reply@lilliput.com`         |
| `OVERLEAF_ADMIN_EMAIL`        | Địa chỉ email để người dùng có thể liên hệ với người phụ trách trang web.                                                                                          | `it-services@lilliput.com`      |

Sau khi bạn đã cập nhật các biến môi trường này, hãy lưu và thoát.
{% endstep %}

{% step %}

### Khởi động phiên bản của bạn

Để khởi động phiên bản của bạn, hãy chạy:

{% code title="Khởi động phiên bản" %}

```
bin/up
```

{% endcode %}

Lệnh này sẽ tải xuống các images cần thiết, tạo các container (sử dụng các tùy chỉnh của bạn), và khởi động phiên bản. Bạn sẽ thấy đầu ra log từ các container Docker khác nhau.

Để khởi động lại chúng sau này (không đính kèm vào đầu ra log), hãy chạy:

{% code title="Khởi động mà không đính kèm vào log" %}

```
bin/start
```

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

{% hint style="info" %}
Toolkit sử dụng `docker compose` để quản lý các container Docker của Overleaf. Toolkit cung cấp một bộ script bao bọc `docker compose` và lo hầu hết các chi tiết cho bạn.
{% endhint %}

Nếu mọi thứ suôn sẻ, bạn sẽ có thể xem trang đăng nhập của phiên bản Overleaf mới bằng cách truy cập <http://127.0.0.1/> hoặc <http://localhost/> trong trình duyệt của bạn.

{% hint style="warning" %}
Tùy thuộc vào cấu hình mạng của bạn và nơi phiên bản Overleaf của bạn được lưu trữ, bạn có thể cần thực hiện thêm các thay đổi cấu hình. Xem cài đặt Toolkit để biết thêm chi tiết:

<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/vi/cai-dat/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.
