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

> Docker Desktop ve Toolkit ile macOS üzerinde yerel bir Ayakaleaf Pro örneği çalıştırın.

Bu bölümde Ayakaleaf Pro'yu Docker Desktop ve [Ayakaleaf Toolkit](https://github.com/ayaka-notes/toolkit) ile Mac'inizde yerel olarak çalıştırıyoruz. Kılavuz `http://localhost:8080` adresini kullanır, verileri ana dizininizde tutar ve korumalı alan (sandboxed) konteynerlerinde TeX Live 2026 ile derleme yapar.

Docker Desktop; uygulamayı, MongoDB'yi, Redis'i ve TeX Live derleyicisini bir Linux sanal makinesinde çalıştırır. MongoDB, Redis veya MacTeX'i doğrudan macOS'a kurmazsınız.

Bu kurulumu kişisel kullanım ve yerel testler için kullanın. Sürekli çalışan, paylaşılan bir hizmet için HTTPS, yedekleme ve erişim denetimiyle birlikte [Linux kılavuzunu](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/linux) öneririz. Mac uyku modundayken veya Docker Desktop durdurulduğunda örneğe erişilemez; bkz. [Örneği erişilebilir tutun](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

## Başlamadan önce

Şunlara ihtiyacınız var:

* [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/) tarafından desteklenen bir macOS sürümü.
* Git, [Homebrew](https://brew.sh/) ve GNU sed. Toolkit, macOS'ta yerleşik olarak bulunan BSD sed'in kabul etmediği GNU sed seçeneklerini kullanır.
* Hem macOS hem de Docker için yeterli kaynak. Küçük bir yerel örnek için Docker Desktop'a 4 CPU ve 8 GB bellek ayırarak başlayın. Bu ölçülmüş bir alt sınır değil, önerilen bir başlangıç noktasıdır.
* Tam bir TeX Live imajı için en az 40 GB boş depolama alanı ve buna ek olarak projeleriniz için yer. Hem Mac'teki boş alanı hem de Docker Desktop'ın disk kullanım sınırını kontrol edin. Tek bir TeX Live sürümüyle başlayın: her ek sürüm yaklaşık olarak aynı miktarda ek alan gerektirir.

Uygulama ve TeX Live imajları `arm64` ve `amd64` için yayımlanır. Apple silicon üzerinde Docker'ın yerel ARM imajını seçmesine izin verin ve `platform: linux/amd64` ayarını zorlamayın.

## Adımlar

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

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

> [card] [2. Toolkit'i tanıyın](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md)

> [card] [3. Yapılandırmayı başlatın](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Ayakaleaf Pro İmajlarını Edinin](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [5. Örneğinizi kişiselleştirme](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md)

> [card] [6. Kurulum sonrası görevler](https://ayakaleaf-pro.mintlify.site/tr/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.