> ## 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 sandboxed compiles và tính bền vững của dữ liệu, và giữ Ayakaleaf Pro luôn chạy trên Windows.

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

Mở [http://localhost:8080/launchpad](http://localhost:8080/launchpad) trong **trình duyệt trên Windows**, 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 hoạt động không chứng minh rằng các container trình biên dịch riêng biệt có thể truy cập thư mục dữ liệu WSL. Hãy tạo một dự án trống và biên dịch tệp `main.tex` này bằng **pdfLaTeX**:

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

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

Chọn **XeLaTeX** và kiểm tra:

```latex theme={null}
\documentclass{article}
\usepackage{fontspec}
\begin{document}
Ayakaleaf WSL XeLaTeX sandbox.
\end{document}
```

Cả hai ví dụ đều hoạt động với image basic. Đối với tài liệu tiếng Trung, hãy dùng một image có chứa `ctex` và các phông chữ cần thiết, chẳng hạn như image full, trước khi kiểm tra đoạn sau với **XeLaTeX**. Image basic không bao gồm chúng:

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

Để xác nhận sandbox đang được sử dụng, hãy chạy trong **Ubuntu** trong khi biên dịch:

```bash theme={null}
docker ps -a --filter ancestor=ghcr.io/ayaka-notes/texlive-basic:2026.1
bin/logs -f clsi
```

Hãy dùng tên image bạn đã chọn trong bộ lọc. Các lần biên dịch ngắn có thể hoàn tất trước khi `docker ps` chạy; `-a` cũng hiển thị các container đã dừng cho đến khi được dọn dẹp. Một container trình biên dịch phải dùng image đó và một bind mount `/compile` từ thư mục dữ liệu WSL của Toolkit. Chỉ riêng log của ứng dụng không thể thay thế cho việc kiểm tra PDF.

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

Trong **Ubuntu**, từ thư mục Toolkit:

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

Đợi ứng dụng khởi động, mở lại dự án từ Windows 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 đó. Dữ liệu đang hoạt động mặc định nằm trong `~/ayakaleaf-toolkit/data/` bên trong Ubuntu. Hãy giữ cả `config/` và `data/`; việc gỡ cài đặt hoặc hủy đăng ký bản phân phối Ubuntu có thể xóa chúng.

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

Có ba yếu tố để giữ phiên bản luôn chạy: Windows luôn thức, Docker Desktop đang chạy, và các container khởi động lại cùng với engine.

Trong **Settings → General** của Docker Desktop, bật **Start Docker Desktop when you sign in to your computer**, xem [Thiết lập Docker Desktop](https://docs.docker.com/desktop/settings-and-maintenance/settings/). Thiết lập này khởi động Docker sau khi đăng nhập, không phải trước khi đăng nhập. Sau khi Windows khởi động lại, hãy đăng nhập, đợi Docker Desktop khởi động xong, mở Ubuntu và kiểm tra `docker ps` cũng như trang web.

**Resource Saver** của Docker Desktop tách biệt với chế độ ngủ của Windows. Nó thường chỉ kích hoạt khi không có container nào đang chạy; ứng dụng, MongoDB và Redis đang chạy sẽ ngăn điều kiện nhàn rỗi đó. Trên WSL 2, nó tạm dừng Docker engine thay vì tắt máy ảo WSL dùng chung. Không **Pause** Docker Desktop thủ công trong khi đang phục vụ người dùng. Bạn không cần tắt Resource Saver chỉ để giữ stack này chạy; xem [tài liệu Resource Saver của Docker](https://docs.docker.com/desktop/use-desktop/resource-saver/).

Các dịch vụ của Toolkit sử dụng `restart: always`. Hãy xác minh thiết lập thực tế trong **Ubuntu**:

```bash theme={null}
docker inspect sharelatex mongo redis --format '{{.Name}} restart={{.HostConfig.RestartPolicy.Name}}'
```

Mỗi dịch vụ phải báo `always`. Khi Docker chạy, nó có thể khởi động lại các container hiện có đó mà không cần `bin/up` mới. Một container bị dừng thủ công sẽ vẫn dừng cho đến khi bạn khởi động nó hoặc khởi động lại engine; với `always`, việc khởi động lại engine có thể khởi động lại nó. Xem [hành vi của restart policy trong Docker](https://docs.docker.com/engine/containers/start-containers-automatically/).

| Hành động | Ảnh hưởng đến Ayakaleaf |
| - | - |
| Đóng terminal Ubuntu sau khi chạy `bin/up -d` | Các container chạy ở chế độ detached; terminal không phải là tiến trình giám sát chúng. Hãy giữ Docker Desktop và môi trường WSL luôn khả dụng |
| Đóng cửa sổ Docker Dashboard | Cửa sổ có thể đóng trong khi Docker Desktop tiếp tục chạy trong khay hệ thống |
| Chọn **Quit Docker Desktop** | Dừng engine và khiến trang web không khả dụng; mở lại Docker Desktop để khôi phục |
| Chạy `wsl --shutdown` | Dừng tất cả các bản phân phối WSL và làm gián đoạn backend WSL của Docker; khởi động lại Docker Desktop và mở lại Ubuntu |
| Cho Windows ngủ, ngủ đông hoặc tắt máy | Dịch vụ không khả dụng; chỉ giữ màn hình bật hoặc tắt không thay đổi điều này |
| Chạy `bin/stop` | Dừng phiên bản nhưng vẫn giữ dữ liệu của nó; dùng `bin/start` để tiếp tục |

Để sử dụng lâu dài khi cắm nguồn AC, hãy mở **Settings → System → Power & battery → Screen, sleep & hibernate timeouts** của Windows 11 (một số phiên bản hiển thị **Power** hoặc **Screen and sleep**). Đặt thời gian chờ ngủ khi cắm nguồn thành **Never** và tắt chế độ ngủ đông tự động nếu đã được cấu hình. Màn hình vẫn có thể tắt. Hành động khi gập nắp laptop là một thiết lập riêng; gập nắp có thể khiến máy chuyển sang chế độ ngủ ngay cả khi thời gian chờ ngủ khi nhàn rỗi là Never. Xem [thiết lập nguồn của Windows](https://support.microsoft.com/en-us/windows/experience/power-battery/power-settings-in-windows-11).

Không chạy `wsl --shutdown` như một thao tác dọn dẹp thường xuyên khi trang web đang được sử dụng. Nếu một thay đổi thiết lập WSL cần đến nó, hãy dừng phiên bản trước và lên kế hoạch cho khoảng thời gian gián đoạn. Windows có thể chạy phiên bản liên tục với các thiết lập này. Đối với một dịch vụ dùng chung phải tiếp tục hoạt động qua các lần đăng xuất và khởi động lại không có người giám sát, chúng tôi khuyến nghị [hướng dẫn cho Linux](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/linux).

### Kiểm tra khả năng khôi phục sau khi khởi động lại Docker Desktop

Sau khi lưu công việc và để các lần biên dịch đang chạy hoàn tất, hãy chọn **Restart Docker Desktop** từ menu khắc phục sự cố của Docker Desktop. Đợi engine khởi động, sau đó kiểm tra trong **Ubuntu**:

```bash theme={null}
docker ps
curl -I http://localhost:8080/launchpad
```

Mở dự án hiện có trên Windows và biên dịch lại. Xác nhận rằng tài khoản và mã nguồn vẫn còn tồn tại.

Nếu bạn đã chủ động dừng phiên bản bằng `bin/stop`, hãy dùng `bin/start`. Nếu Docker đang chạy nhưng một dịch vụ bị lỗi, hãy đọc log của nó thay vì tạo lại cấu hình. Windows Update, các bản cập nhật Docker và mất điện vẫn có thể làm gián đoạn một bản cài đặt chạy 24 giờ; hãy giữ các bản sao lưu và kiểm tra khả năng khôi phục sau các đợt bảo trì theo kế hoạch.

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

Khởi động Docker Desktop trong Windows. Mở **Ubuntu**:

```bash theme={null}
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 MongoDB | `bin/docker-compose logs --tail=100 mongo` |
| Đọc log của trình biên dịch | `bin/logs -f clsi` |

`bin/start` không áp dụng các chỉnh sửa cấu hình: hãy dùng `bin/up -d` sau khi thay đổi `config/`. Hãy 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, di chuyển hoặc gỡ bỏ bản phân phối WSL. Sao chép các tệp MongoDB đang hoạt động trong khi cơ sở dữ liệu đang ghi không phải là một bản sao lưu nhất quán.

Hãy giữ `127.0.0.1` khi dùng cục bộ. Để phục vụ các máy tính khác, bạn cũng cần chủ động thiết lập địa chỉ lắng nghe, URL trang web, cấu hình tường lửa/mạng của Windows và HTTPS; chỉ thay đổi `OVERLEAF_SITE_URL` không publish một cổng.

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/windows/troubleshooting.md).


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