メインコンテンツへスキップ
Ayakaleaf Pro は、公式の Overleaf Community Edition をそのまま置き換えられる製品で、Docker イメージとして提供されます。

インストール方法を選択する

Linux にインストール

Linux で Docker Compose を使用(Docker を含む)

Windows にインストール

Windows で Docker Compose を使用(WSL を利用)

Mac にインストール

macOS で Docker Compose を使用(Docker Desktop)

Kubernetes クラスターで実行

Kubernetes を使用(試験的)

小さなサーバーで実行

小規模サーバー専用(2 GB のスワップが必要)

Claude や Codex にインストールを任せる

Claude または Codex を使用

ブラウザーですぐに試す

GitHub Codespace を使用(最小構成の TeX Live)

既存の Overleaf を移行

既存の Overleaf インスタンスから移行

インターネット接続なしでインストール

社内利用向けのエアギャップ/オフライン環境へのデプロイ
公式の Overleaf Server Pro から移行しますか?(違いは何ですか?)移行する前に issue を作成してください。テンプレートの保存形式が異なるため、無償で移行をお手伝いします。
公式の Overleaf Community Edition に戻したいですか? SERVER_PRO=false を設定する(ayaka-notes Toolkit)か、override ファイルを削除してください(公式 Toolkit)。データが失われることはありません。

ハードウェア要件

私たちのテストでは、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 26.04 は Linux カーネル 7.0 を搭載していますが、MongoDB は Linux カーネル 6.19 から 7.0.13 では起動しません(詳細)。これらのカーネルで実行するには、overleaf-toolkit/config/docker-compose.override.yml(Ayakaleaf Pro のイメージを設定するのと同じファイル)の mongo サービスに次の内容を追加してください。私たちの CI はこの設定で Ubuntu 26.04 上で動作しています。カーネル 7.0.14 以降では不要です。
docker-compose.override.yml
共有サーバーや本番サーバーには Linux をおすすめします。Docker Desktop を使用して、macOS や WSL 2 を使用した Windows で Ayakaleaf Pro を実行することもできます。お使いのプラットフォームに対応するガイドに従ってください。イメージは AMD64 と ARM64 の両方に対応しています。

LaTeX のパフォーマンス

LaTeX はシングルスレッドのプログラムであり、一度に 1 つの CPU コアしか使用できません。1 つのドキュメントをコンパイルする場合、パフォーマンスは主に CPU のシングルコアのクロック速度によって制限されます。そのため、CPU のシングルコア性能が高いほど、ドキュメントを速くコンパイルできます。CPU コア数が多いことが役立つのは、複数のユーザーが同時にドキュメントをコンパイルする場合だけです。 ThuThesis テンプレートを例にとると、コンパイル時間は Intel Core i9-14900K(5.6 GHz)では約 6 秒ですが、AMD EPYC 7763(3.2 GHz)を搭載した Azure Standard D2as v5 インスタンス(2 vCPU、8 GiB RAM)では約 13 秒かかります。 もちろん、実際のコンパイル性能はハードウェア構成によって異なります。ほとんどのサーバー向け CPU は 14900K ほど高いクロック速度では動作しないため、コストとコンパイル速度のトレードオフを考える必要があります。 また、LaTeX のコンパイル性能についても詳細な分析を行っています。興味があれば、ブログ記事 Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host) を参照してください。
最終更新日 2026年11月21日