> ## 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.

# 6. Các tác vụ sau cài đặt

> Tạo quản trị viên, xác minh việc biên dịch và tính bền vững của dữ liệu, và giữ một phiên bản Ayakaleaf Pro cục bộ luôn chạy trên máy Mac của bạn.

### Tạo quản trị viên và dự án đầu tiên

Mở [http://localhost:8080/launchpad](http://localhost:8080/launchpad), tạo tài khoản quản trị viên đầu tiên và đăng nhập. Sau đó làm theo [6. Các tác vụ sau cài đặt](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/linux/6.-post-installation-tasks.md) của hướng dẫn cho Linux, sử dụng cổng `8080` trong các URL ví dụ của nó.

### Xác minh việc biên dịch

Một trang đăng nhập mở được không chứng minh rằng các container trình biên dịch riêng biệt và các data mount của chúng hoạt động. Hãy tạo một dự án trống và biên dịch tệp `main.tex` này:

```latex theme={null}
\documentclass{article}
\begin{document}
Ayakaleaf Pro on macOS.
\end{document}
```

Bản xem trước PDF phải hiển thị văn bản. Nếu cần, hãy chọn TeX Live 2026 trong thiết lập dự án.

Đối với một dự án có văn bản tiếng Trung, hãy chọn **XeLaTeX** làm trình biên dịch và kiểm tra:

```latex theme={null}
\documentclass{ctexart}
\begin{document}
你好，Ayakaleaf Pro。
\end{document}
```

### Xác minh tính bền vững của dữ liệu

```bash theme={null}
bin/stop
bin/start
```

Mở lại dự án và biên dịch lại. Tài khoản, mã nguồn và các tệp dự án của bạn vẫn phải còn đó. Với các đường dẫn mặc định, dữ liệu đang hoạt động nằm trong thư mục `data/` của Toolkit trên máy Mac của bạn.

### Giữ cho phiên bản luôn khả dụng

Khi máy Mac ngủ, macOS tạm dừng máy ảo của Docker Desktop cùng với mọi container trong đó: không ai có thể mở phiên bản, và một lần biên dịch đang chạy sẽ dừng lại cho đến khi máy Mac thức dậy. Chỉ chế độ ngủ của hệ thống là quan trọng. Màn hình có thể tắt.

Nếu có người khác sử dụng phiên bản, hoặc bạn để các tác vụ dài chạy, hãy giữ máy Mac cắm nguồn và ngăn chế độ ngủ tự động, xem [Đặt thiết lập ngủ và thức cho máy Mac của bạn](https://support.apple.com/guide/mac-help/set-sleep-and-wake-settings-mchle41a6ccd/mac):

| Máy Mac | Thiết lập |
| - | - |
| Mac để bàn (Mac mini, iMac, Mac Studio, Mac Pro) | **System Settings → Energy**: bật **Prevent automatic sleeping when the display is off** |
| MacBook | **System Settings → Battery → Options**: bật **Prevent automatic sleeping on power adapter when the display is off**. Thiết lập này chỉ áp dụng khi đang cắm bộ đổi nguồn, và việc gập nắp vẫn khiến MacBook chuyển sang chế độ ngủ |

Để chỉ giữ máy Mac thức trong một khoảng thời gian, hãy chạy `caffeinate -i` trong một cửa sổ Terminal. Lệnh này ngăn chế độ ngủ khi nhàn rỗi cho đến khi bạn nhấn `Ctrl+C` hoặc đóng cửa sổ.

Docker Desktop là một ứng dụng trong phiên người dùng của bạn. Để phiên bản hoạt động trở lại sau khi khởi động lại, hãy bật **Start Docker Desktop when you sign in to your computer** trong **Settings → General** của Docker Desktop. Các container của Toolkit sử dụng `restart: always`, vì vậy Docker sẽ khởi động lại chúng khi Docker Desktop chạy, không cần `bin/up`. Cho đến khi có người đăng nhập vào máy Mac sau khi khởi động lại, phiên bản sẽ không hoạt động.

> [!NOTE]
>
> Một máy Mac luôn thức sẽ tiêu thụ nhiều điện năng hơn. Đối với một dịch vụ phải luôn truy cập được, chúng tôi khuyến nghị một máy chủ Linux, xem [Linux](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/linux).

### Sử dụng hằng ngày

Hãy mở Docker Desktop trước khi bạn quản lý phiên bản. Trong một terminal mới:

```bash theme={null}
export PATH="$(brew --prefix gnu-sed)/libexec/gnubin:$PATH"
cd "$HOME/ayakaleaf-toolkit"
```

| Tác vụ | Lệnh |
| - | - |
| Khởi động các container hiện có | `bin/start` |
| Dừng các container và giữ dữ liệu | `bin/stop` |
| Áp dụng các thay đổi cấu hình | `bin/up -d` |
| Kiểm tra trạng thái | `bin/docker-compose ps` |
| Đọc log khởi động | `bin/docker-compose logs --tail=100 sharelatex` |
| Đọc log của trình biên dịch | `bin/logs -f clsi` |

`bin/start` không áp dụng các thay đổi trong `config/`: hãy chạy `bin/up -d` sau khi bạn chỉnh sửa cấu hình. Hãy giữ `config/` và `data/`, và làm theo [Dữ liệu và sao lưu](https://ayakaleaf-pro.mintlify.site/vi/on-premises/maintenance/data-and-backups) trước khi nâng cấp hoặc trước khi bạn di chuyển bản cài đặt. Sao chép các tệp cơ sở dữ liệu trong khi MongoDB đang ghi vào chúng không phải là một bản sao lưu nhất quán.

Hãy giữ phiên bản trên `127.0.0.1` khi dùng cục bộ. Để phục vụ các máy tính khác, hãy chủ động đặt địa chỉ lắng nghe, URL trang web và HTTPS, xem [5. Cá nhân hóa phiên bản của bạn](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/linux/5.-personalizing-your-instance.md) của hướng dẫn cho Linux.

Nếu có gì đó không hoạt động, hãy xem [Khắc phục sự cố](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/troubleshooting.md).


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