> 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/2.-familiarize-yourself-with-the-toolkit.md).

# 2. Làm quen với Bộ công cụ

### Xem qua một vòng <a href="#taking-a-look-around" id="taking-a-look-around"></a>

Bây giờ bạn đã có một bản sao cục bộ của Toolkit, hãy xem cấu trúc của kho lưu trữ bằng `ls` lệnh.

{% code title="Chạy lệnh này" %}

```bash
ls -l
```

{% endcode %}

{% hint style="info" %}
Trường `ls -l` lệnh này hiển thị chế độ liệt kê dài chi tiết nội dung của một thư mục, cung cấp thêm thông tin tệp như quyền, quyền sở hữu và kích thước.
{% endhint %}

Nếu mọi thứ đã được sao chép thành công, bạn sẽ thấy điều gì đó như sau:

```
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 bin
-rw-r--r-- 1 fry fry  6465 Aug 30 14:16 CHANGELOG.md
drwxr-xr-x 2 fry fry  4096 Sep  6 12:43 config
drwxr-xr-x 5 fry fry  4096 Aug 30 14:22 data
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 doc
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 lib
-rw-r--r-- 1 fry fry 34520 Aug 30 14:16 LICENSE
-rw-r--r-- 1 fry fry  1178 Aug 30 14:16 README.md
```

{% hint style="info" %}
Tất cả các tệp cấu hình do người dùng sở hữu đều nằm trong `config/` thư mục. Thư mục này được **loại trừ** khỏi hệ thống kiểm soát phiên bản git, nên nó sẽ không bị thay đổi khi cập nhật Toolkit.
{% endhint %}

## Bố cục kho lưu trữ

| Tên      | Mô tả                                                                                                                                                                                                                                                  |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `bin`    | Thư mục này chứa một bộ tập lệnh giúp bạn quản lý phiên bản máy chủ Overleaf của mình. Bạn có thể đọc thêm về các tập lệnh này trong mục Lệnh bên dưới.                                                                                                |
| `config` | Thư mục này chứa các tệp cấu hình cục bộ của riêng bạn.                                                                                                                                                                                                |
| `lib`    | Thư mục này chứa các tệp cấu hình cơ bản được Toolkit sử dụng.                                                                                                                                                                                         |
| `data`   | Theo mặc định, thư mục này chứa vị trí lưu trữ cho MongoDb, Redis và Overleaf. Để biết thêm thông tin, xem [Dữ liệu bền vững](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/files-and-locations#persistent-data) phần bên dưới. |

{% hint style="warning" %}
Chúng tôi khuyến nghị **không** thay đổi các tệp bên ngoài `/config` thư mục trực tiếp. Thay vào đó, nếu bạn cần thực hiện thay đổi, có thể làm qua các biến môi trường được đặt trong **config/variables.env** hoặc **config/overleaf.rc**.\
Ví dụ, để đặt `mongo` ảnh của dịch vụ, thay vì chỉnh sửa `lib/docker-compose.mongo.yml` trực tiếp, hãy đặt ảnh bằng biến môi trường `MONGO_IMAGE` trong `config/overleaf.rc`. Để biết thêm thông tin, xem [Cài đặt Toolkit](broken://pages/c54f514c1c4d10f618d65a5964b443d782e4b4e2) trang.
{% endhint %}

{% hint style="info" %}
Toolkit sẽ **không** thay đổi bất kỳ dữ liệu nào trong `config/` thư mục mà không có sự cho phép của bạn.
{% 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/2.-familiarize-yourself-with-the-toolkit.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.
