- Ayakaleaf Pro の機能を試したい、またはデモを体験したいだけであれば、using-the-github-codespace.md のチュートリアルに従ってください。デモ環境では最小構成の TeX Live を使用しているため、一部のプロジェクトは正常にコンパイルできない場合があります。
- これまでどのバージョンの Overleaf もデプロイしたことがない場合は、まず Docker のセットアップを参照して Docker Engine をインストールし、その後 using-the-toolkit に従って Overleaf をインストールしてください。
- すでに Overleaf の Community Edition をデプロイしている場合は、migrate-from-existing.md を参照して Ayakaleaf Pro に移行してください。
- Claude や Codex などのエージェントを使いたい場合は、using-claude-or-codex.md を参照してください。
- オフラインまたはエアギャップ環境にデプロイする必要がある場合は、air-gapped-offline-deployments.md を参照してください。
- 既存の Server Pro ユーザーの場合は、テンプレートデータの保存形式が少し異なるため、Ayakaleaf Pro に移行する前に issue を作成してお知らせください。Server Pro から Ayakaleaf Pro への移行を無償で喜んでお手伝いします。
- もし Ayakaleaf Pro に満足できず、公式の Overleaf Community Edition に戻したくなった場合も、完全にサポートされています。データが失われることはありません。公式の Overleaf Toolkit を使用している場合は、override YAML ファイルを削除するだけです。ayaka-notes toolkit を使用している場合は、
SERVER_PROオプションを無効にしてください。これで標準の Community Edition に戻ります。
GitHub Codespace を使用する
Toolkit を使用する
Claude または Codex を使用する
エアギャップ/オフライン環境でのデプロイ
既存環境からの移行
ハードウェア要件
私たちのテストでは、2 コア・2 GB RAM のサーバーで Overleaf を実行すると、主に Node.js ベースのコアコンポーネントが約 1 GB のメモリを消費することがわかりました。Redis と MongoDB にはさらに 0.5 GB 程度が必要になる場合があり、コンパイル用のサンドボックス Docker コンテナを起動するとさらに 0.3 GB を消費することがあります。つまり、2 コア・2 GB のサーバーで現実的に処理できる同時コンパイルは 1 件程度です。- Ayakaleaf Pro をインストールするための最小ハードウェア要件は、2 コア CPU と 3 GB の RAM です。
- TeX Live イメージのサイズが大きいため、サンドボックスコンパイルを有効にするには少なくとも 40 GB のストレージが必要です。
- 2020 年から 2026 年までの TeX Live イメージをすべてインストールする場合は、少なくとも 150 GB の空きディスク容量を確保してください。
ソフトウェア要件
ソフトウェア要件としては、新しく安定したバージョンの Ubuntu（例：2025〜2026 年なら Ubuntu 24.04、2023〜2024 年なら Ubuntu 22.04）と、最新の安定版 Docker の組み合わせをおすすめします。安定性を最優先してください。リリースされたばかりのものではなく、リリースからある程度時間が経った最新の Ubuntu LTS を選んでください。たとえば 2026 年 10 月時点では、Ubuntu 26.04 はサポートされていません。Linux カーネル 7.0 を搭載しており、MongoDB は Linux カーネル 6.19 から 7.0.13 では起動しないためです（詳細）。Ubuntu 24.04 を使用してください。