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

> Esegui un'istanza locale di Ayakaleaf Pro su macOS con Docker Desktop e il Toolkit.

In questa sezione eseguiamo Ayakaleaf Pro in locale sul tuo Mac con Docker Desktop e l'[Ayakaleaf Toolkit](https://github.com/ayaka-notes/toolkit). La guida usa `http://localhost:8080`, conserva i dati nella tua home directory e compila con TeX Live 2026 in container sandbox.

Docker Desktop esegue l'applicazione, MongoDB, Redis e il compilatore TeX Live in una macchina virtuale Linux. Non installi MongoDB, Redis o MacTeX direttamente su macOS.

Usa questa configurazione per uso personale e test in locale. Per un servizio condiviso sempre attivo, consigliamo la [guida per Linux](https://ayakaleaf-pro.mintlify.site/it/on-premises/installation/using-docker-compose/linux), con HTTPS, backup e controllo degli accessi. L'istanza non è disponibile mentre il Mac è in sospensione o Docker Desktop è arrestato; vedi [Mantenere l'istanza disponibile](https://ayakaleaf-pro.mintlify.site/it/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

## Prima di iniziare

Ti servono:

* Una versione di macOS supportata da [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/).
* Git, [Homebrew](https://brew.sh/) e GNU sed. Il Toolkit usa opzioni di GNU sed che il sed BSD integrato in macOS non accetta.
* Risorse sufficienti sia per macOS sia per Docker. Per una piccola istanza locale, inizia assegnando a Docker Desktop 4 CPU e 8 GB di memoria. Si tratta di un punto di partenza suggerito, non di un minimo misurato.
* Almeno 40 GB di spazio libero per un'immagine TeX Live completa, più lo spazio per i tuoi progetti. Controlla sia lo spazio libero sul Mac sia il limite di utilizzo del disco di Docker Desktop. Inizia con una sola versione di TeX Live: ogni versione aggiuntiva richiede circa altrettanto spazio.

Le immagini dell'applicazione e di TeX Live sono pubblicate per `arm64` e `amd64`. Su Apple silicon, lascia che Docker scelga l'immagine ARM nativa e non forzare `platform: linux/amd64`.

## Passaggi

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

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

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

> [card] [3. Inizializzare la configurazione](https://ayakaleaf-pro.mintlify.site/it/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Ottenere le immagini di Ayakaleaf Pro](https://ayakaleaf-pro.mintlify.site/it/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [5. Personalizzare la tua istanza](https://ayakaleaf-pro.mintlify.site/it/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md)

> [card] [6. Attività post-installazione](https://ayakaleaf-pro.mintlify.site/it/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.