Chuyển đến nội dung chính
Trong phần này, chúng ta sẽ chạy Ayakaleaf Pro cục bộ trên máy Mac của bạn bằng Docker Desktop và Ayakaleaf Toolkit. Hướng dẫn sử dụng http://localhost:8080, lưu dữ liệu trong thư mục home của bạn và biên dịch bằng TeX Live 2026 trong các container sandbox. Docker Desktop chạy ứng dụng, MongoDB, Redis và trình biên dịch TeX Live trong một máy ảo Linux. Bạn không cần cài đặt MongoDB, Redis hay MacTeX trực tiếp trên macOS. Hãy dùng thiết lập này cho mục đích cá nhân và thử nghiệm cục bộ. Đối với một dịch vụ dùng chung luôn hoạt động, chúng tôi khuyến nghị hướng dẫn cho Linux, với HTTPS, sao lưu và kiểm soát truy cập. Phiên bản sẽ không khả dụng khi máy Mac ngủ hoặc Docker Desktop bị dừng, xem Giữ cho phiên bản luôn khả dụng.

Trước khi bắt đầu

Bạn cần:
  • Một phiên bản macOS được hỗ trợ bởi Docker Desktop for Mac.
  • Git, Homebrew và GNU sed. Toolkit sử dụng các tùy chọn GNU sed mà BSD sed tích hợp sẵn trong macOS không chấp nhận.
  • Đủ tài nguyên cho cả macOS và Docker. Đối với một phiên bản cục bộ nhỏ, hãy bắt đầu với 4 CPU và 8 GB bộ nhớ được cấp cho Docker Desktop. Đây là điểm khởi đầu được gợi ý, không phải mức tối thiểu đã được đo lường.
  • Ít nhất 40 GB dung lượng trống cho một TeX Live image đầy đủ, cộng thêm dung lượng cho các dự án của bạn. Hãy kiểm tra cả dung lượng trống trên máy Mac và giới hạn sử dụng ổ đĩa của Docker Desktop. Hãy bắt đầu với một phiên bản TeX Live: mỗi phiên bản bổ sung cần thêm khoảng chừng ấy dung lượng nữa.
Các image ứng dụng và TeX Live được phát hành cho arm64 và amd64. Trên Apple silicon, hãy để Docker chọn image ARM gốc và không ép buộc platform: linux/amd64.

Các bước

0. Cài đặt Docker Desktop

1. Tải xuống Toolkit

2. Làm quen với Toolkit

3. Khởi tạo cấu hình

4. Tải image Ayakaleaf Pro

5. Cá nhân hóa phiên bản của bạn

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

Lần sửa đổi cuối 8 tháng 11, 2026