> 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/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 dành cho các triển khai Toolkit.

Trường `config/overleaf.rc` tệp 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 container 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 cung cấp 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ó một 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 Toolkit biết 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 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 trữ các kho git. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng `/`), 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 có sẵn: <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 Toolkit biết dùng kỹ thuật <strong>Sibling Containers</strong> để biên dịch dự án trong các hộp cát riêng biệt, 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 Toolkit biết 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 Docker socket 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 <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 địa chỉ IP máy chủ mà container sẽ lắng nghe. 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 nào của máy chủ. Để truy cập trực tiếp container, 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 <code>0.0.0.0</code> hoặc IP ngoài của máy chủ bạn 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ẽ lắng nghe. 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 để làm cho log ứng dụng có sẵn trên Docker host. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng <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 để tắt bind-mount. Khi không được đặt, 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> không được đặt</p>                                      |

***

### `mongo`

| Tên               | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MONGO_ENABLED`   | <p>Khi được đặt thành <code>true</code>, cho Toolkit biết tạo một container MongoDB để lưu trữ cơ sở dữ liệu. Khi đặ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 sẽ dùng khi <code>MONGO\_ENABLED</code> là <code>false</code>.<br><br>- <strong>Mặc định</strong>: không được đặ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 trữ cơ sở dữ liệu MongoDB. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng <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 local <code>mongo</code> container đượ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 vào <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 chính của MongoDB 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 Toolkit biết tạo một container Redis để lưu trữ cơ sở dữ liệu redis. Khi đặ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 sẽ dùng khi <code>REDIS\_ENABLED</code> là <code>false</code>.<br><br>- <strong>Mặc định</strong>: không được đặt</p>                                                                                                                                                                                                                                                                                           |
| `REDIS_PORT`            | <p>Chỉ định cổng Redis sẽ dùng khi <code>REDIS\_ENABLED</code> là <code>false</code>.<br><br>- <strong>Mặc định</strong>: không được đặ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 trữ cơ sở dữ liệu Redis. Đây có thể là một đường dẫn đầy đủ (bắt đầu bằng <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 local <code>redis</code> container đượ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>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 Toolkit biết tạo một container NGINX để hoạt động như một TLS Proxy.<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 sẽ dùng cho TLS Proxy.<br><br>- <strong>Mặc định</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                                                                                                  |
| `NGINX_TLS_LISTEN_IP`  | <p>Đặt địa chỉ IP máy chủ mà container TLS Proxy sẽ lắng nghe 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 nào của máy chủ. Thông thường nên đặt thành IP 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 địa chỉ IP máy chủ mà container TLS Proxy sẽ lắng nghe 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 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 TLS Proxy sẽ lắng nghe cho HTTP.<br><br>- <strong>Mặc định</strong>: <code>80</code></p>                                                                                                                                                                                                                                                                                                                                                |
| `TLS_PORT`             | <p>Đặt cổng máy chủ mà container TLS Proxy sẽ lắng nghe 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 tư sẽ dùng cho TLS Proxy.<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 sẽ dùng cho TLS Proxy.<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://overleaf-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.