Vai al contenuto principale
In questa sezione eseguiamo Ayakaleaf Pro in locale sul tuo Mac con Docker Desktop e l’Ayakaleaf 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, 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.

Prima di iniziare

Ti servono:
  • Una versione di macOS supportata da Docker Desktop for Mac.
  • Git, Homebrew 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

0. Configurare Docker Desktop

1. Scaricare il Toolkit

2. Familiarizzare con il Toolkit

3. Inizializzare la configurazione

4. Ottenere le immagini di Ayakaleaf Pro

5. Personalizzare la tua istanza

6. Attività post-installazione

Ultima modifica il 8 novembre 2026