> 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/cau-hinh/overleaf-toolkit/toolkit-settings.md).

# Cài đặt Toolkit

Trang này mô tả các biến môi trường được hỗ trợ trong `config/overleaf.rc` tệp cho các triển khai Toolkit.

Trường `config/overleaf.rc` tệp bao gồm các định nghĩa biến theo dạng `NAME=value`. Các dòng bắt đầu bằng `#` được coi là chú thích.

{% hint style="info" %}
Bạn cần tạo lại các vùng chứa Docker sau khi thay đổi bất kỳ điều gì trong `overleaf.rc` hoặc `variables.env` bằng cách chạy `bin/up`.
{% endhint %}

## Container

### `sharelatex`

| Tên                          | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PROJECT_NAME`               | <p>Đặt giá trị của <code>--project-name</code> cờ được truyền cho <code>docker-compose</code>. Điều này hữu ích khi chạy nhiều phiên bản Overleaf trên một máy chủ, vì mỗi phiên bản có thể có tên dự án khác nhau.<br><br>- <strong>Mặc định</strong>: <code>overleaf</code></p>                                                                                                                                                                                                                                                                 |
| `OVERLEAF_IMAGE_NAME`        | <p>Ảnh Docker được dùng bởi container ứng dụng Server Pro/CE. Đây chỉ là tên ảnh Docker; thẻ ảnh Docker được lấy từ <code>config/version</code>.<br><br>- <strong>Mặc định:</strong><br>- Server Pro: <code>quay.io/sharelatex/sharelatex-pro</code><br>- Community Edition: <code>sharelatex/sharelatex</code></p>                                                                                                                                                                                                                               |
| `SERVER_PRO`                 | <p>Khi được đặt thành <code>true</code>, cho biết Toolkit sử dụng ảnh Server Pro (<code>quay.io/sharelatex/sharelatex-pro</code>), thay vì ảnh Server CE mặc định (<code>sharelatex/sharelatex</code>).<br><br>- <strong>Mặc định</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                |
| `GIT_BRIDGE_ENABLED`         | <p>Đặt thành <code>true</code> để bật tính năng git-bridge (chỉ Server Pro). Để biết thêm thông tin, xem <a href="https://www.overleaf.com/learn/how-to/Git_integration"><https://www.overleaf.com/learn/how-to/Git_integration></a> tài liệu hướng dẫn cho người dùng.<br><br>- <strong>Mặc định:</strong> <code>false</code></p>                                                                                                                                                                                                                |
| `GIT_BRIDGE_IMAGE`           | <p>Ảnh Docker được dùng bởi container git-bridge (chỉ Server Pro). Đây chỉ là tên ảnh Docker; thẻ ảnh Docker được lấy từ <code>config/version</code>.<br><br>- <strong>Mặc định:</strong> <code>quay.io/sharelatex/git-bridge</code></p>                                                                                                                                                                                                                                                                                                          |
| `GIT_BRIDGE_DATA_PATH`       | Đặt đường dẫn đến thư mục sẽ được gắn vào `git-bridge` container (chỉ Server Pro), và được dùng để lưu các kho git. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng một `/`), hoặc tương đối so với thư mục gốc của Toolkit.                                                                                                                                                                                                                                                                                                                     |
| `GIT_BRIDGE_LOG_LEVEL`       | <p>Cấu hình mức ghi log của <code>git-bridge</code> container. Các mức khả dụng: <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>.<br><br>- <strong>Mặc định:</strong> <code>INFO</code></p>                                                                                                                                                                                                                                                                                                      |
| `SIBLING_CONTAINERS_ENABLED` | <p>Khi được đặt thành <code>true</code>, cho biết Toolkit sử dụng kỹ thuật <strong>Sibling Containers</strong> kỹ thuật biên dịch dự án trong các sandbox riêng biệt, sử dụng một container Docker riêng cho mỗi dự án. Xem tài liệu \<server-pro-only-configuration/sandboxed-compiles> để biết thêm thông tin.<br><br>- <strong>Yêu cầu:</strong> <code>SERVER\_PRO=true</code><br>- <strong>Mặc định:</strong> <code>true</code></p>                                                                                                           |
| `SIBLING_CONTAINERS_PULL`    | <p>Khi được đặt thành <code>true</code>, cho biết Toolkit tự động kéo tất cả các ảnh TeX Live được đặt bằng <code>ALL\_TEX\_LIVE\_DOCKER\_IMAGES</code> trong <strong>config/variables.env</strong> tệp khi sử dụng <code>bin/up</code> lệnh.<br><br>- <strong>Mặc định:</strong> <code>true</code></p>                                                                                                                                                                                                                                           |
| `DOCKER_SOCKET_PATH`         | <p>Đặt đường dẫn đến socket Docker trên máy chủ (máy đang chạy Toolkit). Khi <code>SIBLING\_CONTAINERS\_ENABLED</code> là <code>true</code>, socket sẽ được gắn vào container để cho phép dịch vụ biên dịch tạo các container Docker mới trên máy chủ.<br><br>- <strong>Yêu cầu:</strong> <code>SIBLING\_CONTAINERS\_ENABLED=true</code><br>- <strong>Mặc định:</strong> <code>/var/run/docker.sock</code></p>                                                                                                                                    |
| `OVERLEAF_DATA_PATH`         | <p>Đặt đường dẫn đến thư mục sẽ được gắn vào container chính <code>sharelatex</code> container, và được dùng để lưu dữ liệu biên dịch. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng một <code>/</code>), hoặc tương đối so với thư mục gốc của Toolkit.<br><br>- <strong>Mặc định:</strong> <code>data/overleaf</code></p>                                                                                                                                                                                                                    |
| `OVERLEAF_LISTEN_IP`         | <p>Đặt (các) địa chỉ IP máy chủ mà container sẽ ràng buộc. Ví dụ, nếu được đặt thành <code>0.0.0.0</code>, thì giao diện web sẽ khả dụng trên bất kỳ địa chỉ IP máy chủ nào. Đối với truy cập container trực tiếp, giá trị của <code>OVERLEAF\_LISTEN\_IP</code> phải được đặt thành địa chỉ IP công khai của bạn. Việc đặt <code>OVERLEAF\_LISTEN\_IP</code> thành một trong hai giá trị <code>0.0.0.0</code> hoặc IP bên ngoài của máy chủ thường sẽ gây lỗi khi dùng cùng với .<br><br>- <strong>Mặc định:</strong> <code>127.0.0.1</code></p> |
| `OVERLEAF_PORT`              | <p>Đặt cổng máy chủ mà container sẽ ràng buộc. Ví dụ, nếu được đặt thành <code>8099</code> và <code>OVERLEAF\_LISTEN\_IP</code> được đặt thành <code>127.0.0.1</code>, thì giao diện web sẽ khả dụng tại <code><http://localhost:8099></code>.<br><br>- <strong>Mặc định:</strong> <code>80</code></p>                                                                                                                                                                                                                                            |
| `OVERLEAF_LOG_PATH`          | <p>Đặt đường dẫn đến thư mục sẽ được gắn vào container chính <code>sharelatex</code> container, và được dùng để đưa log ứng dụng khả dụng trên máy chủ Docker. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng một <code>/</code>), hoặc tương đối so với thư mục gốc của Toolkit. Xóa mục cấu hình để vô hiệu hóa bind-mount. Khi không được đặt, các log sẽ bị loại bỏ khi tạo lại container.<br><br>Xem để biết thông tin về ghi log.<br><br>- <strong>Mặc định:</strong> chưa đặt</p>                                                        |

***

### `mongo`

| Tên               | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MONGO_ENABLED`   | <p>Khi được đặt thành <code>true</code>, cho biết Toolkit tạo một container MongoDB để lưu trữ cơ sở dữ liệu. Khi được đặt thành <code>false</code>, container này sẽ không được tạo, và hệ thống sẽ sử dụng cơ sở dữ liệu MongoDB được chỉ định bởi <code>MONGO\_URL</code> thay vào đó.<br><br>- <strong>Mặc định</strong>: <code>true</code></p>                                                                                          |
| `MONGO_URL`       | <p>Chỉ định URL kết nối MongoDB để dùng khi <code>MONGO\_ENABLED</code> là <code>false</code>.<br><br>- <strong>Mặc định</strong>: chưa đặt</p>                                                                                                                                                                                                                                                                                              |
| `MONGO_DATA_PATH` | <p>Đặt đường dẫn đến thư mục sẽ được gắn vào <code>mongo</code> container, và được dùng để lưu cơ sở dữ liệu MongoDB. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng một <code>/</code>), hoặc tương đối so với thư mục gốc của toolkit. Tùy chọn này chỉ ảnh hưởng đến container cục bộ <code>mongo</code> được tạo khi <code>MONGO\_ENABLED</code> là <code>true</code>.<br><br>- <strong>Mặc định</strong>: <code>data/mongo</code></p> |
| `MONGO_IMAGE`     | <p>Ảnh Docker được dùng bởi container MongoDB. Đây chỉ là tên ảnh Docker; thẻ ảnh Docker nên được đặt trong <code>MONGO\_VERSION</code> (xem bên dưới).<br><br>- <strong>Mặc định:</strong> <code>mongo</code></p>                                                                                                                                                                                                                           |
| `MONGO_VERSION`   | <p>Phiên bản MongoDB được dùng bởi container MongoDB. Giá trị phải bắt đầu bằng phiên bản MongoDB chính và một dấu chấm, ví dụ <code>6.0</code> hoặc <code>6.0-with-suffix</code>.<br><br>- <strong>Mặc định:</strong> <code>6.0</code></p>                                                                                                                                                                                                  |

***

### `redis`

| Tên                     | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `REDIS_ENABLED`         | <p>Khi được đặt thành <code>true</code>, cho biết Toolkit tạo một container Redis để lưu trữ cơ sở dữ liệu Redis. Khi được đặt thành <code>false</code>, container này sẽ không được tạo, và hệ thống sẽ sử dụng cơ sở dữ liệu Redis được chỉ định bởi <code>REDIS\_HOST</code> và <code>REDIS\_PORT</code> thay vào đó.<br><br>- <strong>Mặc định</strong>: <code>true</code></p>                                                         |
| `REDIS_HOST`            | <p>Chỉ định máy chủ Redis để dùng khi <code>REDIS\_ENABLED</code> là <code>false</code>.<br><br>- <strong>Mặc định</strong>: chưa đặt</p>                                                                                                                                                                                                                                                                                                  |
| `REDIS_PORT`            | <p>Chỉ định cổng Redis để dùng khi <code>REDIS\_ENABLED</code> là <code>false</code>.<br><br>- <strong>Mặc định</strong>: chưa đặt</p>                                                                                                                                                                                                                                                                                                     |
| `REDIS_DATA_PATH`       | <p>Đặt đường dẫn đến thư mục sẽ được gắn vào <code>redis</code> container, và được dùng để lưu cơ sở dữ liệu Redis. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng một <code>/</code>), hoặc tương đối so với thư mục gốc của Toolkit. Tùy chọn này chỉ ảnh hưởng đến container cục bộ <code>redis</code> được tạo khi <code>REDIS\_ENABLED</code> là <code>true</code>.<br><br>- <strong>Mặc định</strong>: <code>data/redis</code></p> |
| `REDIS_AOF_PERSISTENCE` | <p>Bật tính bền vững AOF (Append Only File) cho Redis. Đây là <strong>được khuyến nghị</strong> cấu hình được khuyến nghị cho tính bền vững của Redis.<br><br>Để biết thêm chi tiết, xem mục <../../../maintenance/data-and-backups#aof-append-only-file> trong <../../maintenance/data-and-backups>.<br><br>- <strong>Mặc định:</strong> <code>true</code></p>                                                                            |

***

### `nginx`

| Tên                    | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NGINX_ENABLED`        | <p>Khi được đặt thành <code>true</code>, cho biết Toolkit tạo một container NGINX để làm proxy TLS.<br><br>- <strong>Mặc định</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                                                      |
| `NGINX_CONFIG_PATH`    | <p>Đường dẫn đến tệp cấu hình NGINX để dùng cho proxy TLS.<br><br>- <strong>Mặc định</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                                                                                                             |
| `NGINX_TLS_LISTEN_IP`  | <p>Đặt (các) địa chỉ IP máy chủ mà container proxy TLS sẽ ràng buộc cho HTTPS. Ví dụ, nếu được đặt thành <code>0.0.0.0</code> , thì giao diện web HTTPS sẽ khả dụng trên bất kỳ địa chỉ IP máy chủ nào. Thông thường, nên đặt thành IP bên ngoài của máy chủ bạn.<br><br>- <strong>Mặc định</strong>: <code>127.0.1.1</code></p>                                                                                                                                                    |
| `NGINX_HTTP_LISTEN_IP` | <p>Đặt (các) địa chỉ IP máy chủ mà container proxy TLS sẽ ràng buộc cho chuyển hướng HTTP. Ví dụ, nếu được đặt thành <code>127.0.1.1</code> thì các kết nối HTTP tới <code>127.0.1.1</code> sẽ được chuyển hướng đến giao diện web HTTPS. Thông thường, nên đặt thành IP bên ngoài của máy chủ bạn. Đừng đặt nó thành <code>0.0.0.0</code> vì điều này thường sẽ gây xung đột với <code>OVERLEAF\_LISTEN\_IP</code>.<br><br>- <strong>Mặc định</strong>: <code>127.0.1.1</code></p> |
| `NGINX_HTTP_PORT`      | <p>Đặt cổng máy chủ mà container proxy TLS sẽ ràng buộc cho HTTP.<br><br>- <strong>Mặc định</strong>: <code>80</code></p>                                                                                                                                                                                                                                                                                                                                                           |
| `TLS_PORT`             | <p>Đặt cổng máy chủ mà container proxy TLS sẽ ràng buộc cho HTTPS.<br><br>- <strong>Mặc định</strong>: <code>443</code></p>                                                                                                                                                                                                                                                                                                                                                         |
| `TLS_PRIVATE_KEY_PATH` | <p>Đường dẫn đến khóa riêng để dùng cho proxy TLS.<br><br>- <strong>Mặc định</strong>: <code>config/nginx/certs/overleaf\_key.pem</code></p>                                                                                                                                                                                                                                                                                                                                        |
| `TLS_CERTIFICATE_PATH` | <p>Đường dẫn đến chứng chỉ công khai để dùng cho proxy TLS.<br><br>- <strong>Mặc định</strong>: <code>config/nginx/certs/overleaf\_certificate.pem</code></p>                                                                                                                                                                                                                                                                                                                       |


---

# 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/cau-hinh/overleaf-toolkit/toolkit-settings.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.