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, 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 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:

\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:

\documentclass{ctexart}
\begin{document}
你好，Ayakaleaf Pro。
\end{document}

​

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

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:

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.

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.

​

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:

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