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

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

### Tùy chỉnh 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 chạy 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 yêu thích của bạn và cập nhật các biến môi trường bên dưới với các giá trị được yêu cầu.
{% 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 truy cập 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 `từ` địa chỉ 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 quản lý 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, 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 image 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 nhật ký từ các container Docker khác nhau.

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

{% code title="Khởi động mà không gắn 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à xử lý 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 phần 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://ayakaleaf-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.