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

# macOS

> Chạy một phiên bản Ayakaleaf Pro cục bộ trên macOS bằng Docker Desktop và Toolkit.

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](https://github.com/ayaka-notes/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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

## 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](https://docs.docker.com/desktop/setup/install/mac-install/).
* Git, [Homebrew](https://brew.sh/) 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

> [card] [0. Cài đặt Docker Desktop](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md)

> [card] [1. Tải xuống Toolkit](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md)

> [card] [2. Làm quen với Toolkit](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md)

> [card] [3. Khởi tạo cấu hình](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Tải image Ayakaleaf Pro](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [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/macos/5.-personalizing-your-instance.md)

> [card] [6. Các tác vụ sau cài đặt](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md)


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