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

> Jalankan instance Ayakaleaf Pro lokal di macOS dengan Docker Desktop dan Toolkit.

Di bagian ini kita menjalankan Ayakaleaf Pro secara lokal di Mac Anda dengan Docker Desktop dan [Ayakaleaf Toolkit](https://github.com/ayaka-notes/toolkit). Panduan ini menggunakan `http://localhost:8080`, menyimpan data di direktori home Anda, dan melakukan kompilasi dengan TeX Live 2026 di kontainer sandbox.

Docker Desktop menjalankan aplikasi, MongoDB, Redis, dan compiler TeX Live di mesin virtual Linux. Anda tidak perlu menginstal MongoDB, Redis, atau MacTeX di macOS itu sendiri.

Gunakan penyiapan ini untuk penggunaan pribadi dan pengujian lokal. Untuk layanan bersama yang selalu aktif, kami merekomendasikan [panduan Linux](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/linux), dengan HTTPS, backup, dan kontrol akses. Instance tidak tersedia saat Mac dalam mode tidur atau Docker Desktop dihentikan, lihat [Menjaga instance tetap tersedia](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

## Sebelum memulai

Anda memerlukan:

* Versi macOS yang didukung oleh [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/).
* Git, [Homebrew](https://brew.sh/), dan GNU sed. Toolkit menggunakan opsi GNU sed yang tidak diterima oleh BSD sed bawaan macOS.
* Sumber daya yang cukup untuk macOS dan Docker. Untuk instance lokal kecil, mulailah dengan 4 CPU dan memori 8 GB yang dialokasikan ke Docker Desktop. Ini adalah titik awal yang disarankan, bukan batas minimum hasil pengukuran.
* Ruang penyimpanan kosong minimal 40 GB untuk image TeX Live lengkap, ditambah ruang untuk proyek Anda. Periksa ruang kosong di Mac dan batas penggunaan disk Docker Desktop. Mulailah dengan satu versi TeX Live: setiap versi tambahan membutuhkan ruang yang kurang lebih sama besarnya.

Image aplikasi dan TeX Live dipublikasikan untuk `arm64` dan `amd64`. Di Apple silicon, biarkan Docker memilih image ARM native dan jangan memaksakan `platform: linux/amd64`.

## Langkah-langkah

> [card] [0. Menyiapkan Docker Desktop](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md)

> [card] [1. Mengunduh Toolkit](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md)

> [card] [2. Kenali Toolkit](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md)

> [card] [3. Inisialisasi konfigurasi](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Dapatkan Image Ayakaleaf Pro](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [5. Menyesuaikan instance Anda](https://ayakaleaf-pro.mintlify.site/id/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md)

> [card] [6. Tugas pasca-instalasi](https://ayakaleaf-pro.mintlify.site/id/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.