メインコンテンツへスキップ
このセクションでは、Docker Desktop と Ayakaleaf Toolkit を使用して、Mac 上でローカルに Ayakaleaf Pro を実行します。このガイドでは http://localhost:8080 を使用し、データをホームディレクトリに保存し、サンドボックス化されたコンテナ内の TeX Live 2026 でコンパイルします。 Docker Desktop は、アプリケーション、MongoDB、Redis、TeX Live コンパイラーを Linux 仮想マシン内で実行します。macOS 自体に MongoDB、Redis、MacTeX をインストールする必要はありません。 この構成は個人での使用やローカルでのテストに使用してください。常時稼働する共有サービスには、HTTPS、バックアップ、アクセス制御を備えた Linux ガイドをおすすめします。Mac がスリープしている間や Docker Desktop が停止している間は、インスタンスを利用できません。インスタンスを利用可能な状態に保つを参照してください。

始める前に

必要なもの:
  • Docker Desktop for Mac がサポートする macOS のバージョン。
  • Git、Homebrew、GNU sed。Toolkit は、macOS に組み込まれている BSD sed では受け付けられない GNU sed のオプションを使用します。
  • macOS と Docker の両方に十分なリソース。小規模なローカルインスタンスの場合は、まず Docker Desktop に 4 CPU と 8 GB のメモリを割り当ててください。これは推奨される出発点であり、測定された最小要件ではありません。
  • フル TeX Live イメージ用に少なくとも 40 GB の空きストレージと、プロジェクト用の容量。Mac の空き容量と Docker Desktop のディスク使用量の上限の両方を確認してください。まずは 1 つの TeX Live バージョンから始めてください。バージョンを追加するたびに、ほぼ同じ容量が追加で必要になります。
アプリケーションと TeX Live のイメージは arm64 と amd64 向けに公開されています。Apple シリコンでは、Docker にネイティブの ARM イメージを選択させ、platform: linux/amd64 を強制しないでください。

手順

0. Docker Desktop のセットアップ

1. Toolkit をダウンロードする

2. Toolkit に慣れる

3. 設定の初期化

4. Ayakaleaf Pro イメージの取得

5. インスタンスのカスタマイズ

6. インストール後のタスク

最終更新日 2026年11月8日