> ## 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 と Toolkit を使用して、macOS 上でローカルの Ayakaleaf Pro インスタンスを実行します。

このセクションでは、Docker Desktop と [Ayakaleaf Toolkit](https://github.com/ayaka-notes/toolkit) を使用して、Mac 上でローカルに Ayakaleaf Pro を実行します。このガイドでは `http://localhost:8080` を使用し、データをホームディレクトリに保存し、サンドボックス化されたコンテナ内の TeX Live 2026 でコンパイルします。

Docker Desktop は、アプリケーション、MongoDB、Redis、TeX Live コンパイラーを Linux 仮想マシン内で実行します。macOS 自体に MongoDB、Redis、MacTeX をインストールする必要はありません。

この構成は個人での使用やローカルでのテストに使用してください。常時稼働する共有サービスには、HTTPS、バックアップ、アクセス制御を備えた [Linux ガイド](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/linux)をおすすめします。Mac がスリープしている間や Docker Desktop が停止している間は、インスタンスを利用できません。[インスタンスを利用可能な状態に保つ](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available)を参照してください。

## 始める前に

必要なもの:

* [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/) がサポートする macOS のバージョン。
* Git、[Homebrew](https://brew.sh/)、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` を強制しないでください。

## 手順

> [card] [0. Docker Desktop のセットアップ](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md)

> [card] [1. Toolkit をダウンロードする](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md)

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

> [card] [3. 設定の初期化](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Ayakaleaf Pro イメージの取得](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [5. インスタンスのカスタマイズ](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md)

> [card] [6. インストール後のタスク](https://ayakaleaf-pro.mintlify.site/ja/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.