> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tệp và vị trí

Trang này mô tả các tệp cấu hình mà Toolkit sử dụng để cấu hình bản triển khai Overleaf on-premises của bạn.

### Dữ liệu lưu trữ lâu dài

Overleaf Toolkit cần lưu trữ dữ liệu lâu dài, chẳng hạn như các tệp cần thiết để biên dịch dự án LaTeX và nội dung của cơ sở dữ liệu MongoDB. Điều này được thực hiện bằng cách mount một số thư mục từ máy chủ host vào các Docker container và ghi dữ liệu vào các thư mục đó.

#### Thư mục dữ liệu

Container `sharelatex` cần một thư mục để lưu trữ dữ liệu liên quan đến việc biên dịch LaTeX. Thư mục này được đặt bằng biến `OVERLEAF_DATA_PATH` trong `config/overleaf.rc`.

Container `mongo`, nếu được bật, cần một thư mục để lưu các tệp cơ sở dữ liệu, và điều tương tự cũng áp dụng cho container `redis`. Các thư mục này cũng có thể được cấu hình trong `config/overleaf.rc`.

#### Quyền truy cập tệp

Vì Docker chạy dưới quyền `root`, các thư mục dữ liệu sẽ thuộc sở hữu của người dùng `root`, ngay cả khi Toolkit được sử dụng bởi người dùng không phải root. Đây không phải là vấn đề, nhưng bạn nên lưu ý nếu định thay đổi dữ liệu lưu trữ từ bên ngoài các container.

### Vị trí tệp cấu hình

Tất cả các tệp cấu hình do người dùng sở hữu đều nằm trong thư mục `config/`.

Thư mục này được **loại trừ** khỏi hệ thống quản lý phiên bản git, vì vậy nó sẽ không bị thay đổi khi cập nhật mã nguồn Toolkit. Toolkit sẽ **không** thay đổi bất kỳ dữ liệu nào trong thư mục `config/` khi chưa có sự cho phép của bạn.

<Info>
  Các thay đổi trong tệp cấu hình sẽ không được tự động áp dụng cho các container hiện có, ngay cả khi container bị dừng và khởi động lại (bằng `bin/stop` và `bin/start`). Để áp dụng thay đổi, hãy chạy `bin/up`, và ở phía sau, `docker compose` sẽ tự động áp dụng các thay đổi cấu hình cho một container mới. (Hoặc chạy `bin/up -d` nếu bạn không muốn gắn vào log của Docker.)
</Info>

### Tệp `overleaf.rc`

Tệp `config/overleaf.rc` chứa các thiết lập cấu hình cấp cao quan trọng nhất được Toolkit sử dụng. Tệp này chứa các câu lệnh gán biến theo định dạng: `VARIABLE_NAME=value`

Để xem chi tiết tất cả các tùy chọn cấu hình khả dụng, hãy xem phần thiết lập của chúng tôi.

### Tệp `variables.env`

Tệp `config/variables.env` chứa các biến môi trường được nạp vào container `sharelatex` và dùng để cấu hình các microservice của Overleaf. Chúng bao gồm tên ứng dụng (hiển thị trên header của giao diện web), thiết lập gửi email và các thiết lập cao cấp khác như SSO dùng với Server Pro.

Để xem chi tiết tất cả các biến môi trường khả dụng, hãy xem phần [Biến môi trường](/vi/on-premises/configuration/overleaf-toolkit/environment-variables).

### Tệp `version`

Tệp `config/version` chứa số phiên bản của Docker image sẽ được dùng để tạo phiên bản đang chạy của máy chủ Overleaf.

<Info>
  Các thay đổi trong những tệp cấu hình này sẽ không được tự động áp dụng cho các container hiện có, ngay cả khi container bị dừng và khởi động lại (bằng `bin/stop` và `bin/start`). Để áp dụng thay đổi, hãy chạy `bin/up`, và Toolkit sẽ tự động tạo một container mới với các thay đổi cấu hình đã được áp dụng.
</Info>

### Tệp `docker-compose.override.yml`

Nếu tồn tại, tệp `config/docker-compose.override.yml` sẽ được đưa vào khi gọi `docker compose`. Điều này hữu ích để ghi đè các cấu hình dành riêng cho Docker Compose.

Xem [tài liệu docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) để biết thêm chi tiết.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.