メインコンテンツへスキップ
2 GB のスワップを追加すれば、Ayakaleaf Pro は Git 連携を含めて 2 CPU コア・2 GB メモリのサーバーで動作します。スワップがないと、起動中にメモリ不足になります。さらにステップ 2 の設定で、スワップ使用量をほぼ半分に減らせます。
この測定は、Ubuntu 24.04 を実行する 2 vCPU / 2 GiB の QEMU/KVM 仮想マシン上で、Toolkit を使った Ayakaleaf Pro 6.3.1 に対し、サンドボックスコンパイル(texlive-basic:2025.1)と Git 連携を有効にして行いました。

デフォルトでは 2 GB では足りない理由

デフォルト設定のままだと、Ayakaleaf Pro はアイドル時に約 1.9 GiB を必要とします。2 GiB のマシンでは Ubuntu と Docker がすでに 364 MiB を使用しているため、残りは約 1600 MiB です。

  1. 2 GB のスワップを追加する

これが最も重要なステップです。

  1. メモリ使用量を減らす

次の行を config/variables.env に追加します。Git 連携コンテナもこのファイルを読み込みます。
variables.env
MongoDB のキャッシュに上限を設けるには、config/docker-compose.override.yml(Ayakaleaf Pro イメージを設定しているのと同じファイル)の services の下に mongo エントリを追加します。
docker-compose.override.yml
その後、bin/up -d を実行します。
NODE_OPTIONS はイメージで設定された値を置き換えるため、この行には --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs を残す必要があります。これらがないと、Node.js サービスはパッケージを読み込めず、起動しません。--optimize-for-size は使用できません。Node.js は NODE_OPTIONS でこのオプションを受け付けません。--replSet overleaf は、Toolkit がデフォルトで MongoDB に渡すオプションです。削除しないでください。
ヒープが 160 MiB の場合、大きなプロジェクトを Git でクローンまたはプッシュするとメモリ不足になり、Git 連携コンテナが再起動することがあります。これはテストしていません。発生した場合は -Xmx を引き上げてください。

結果

各テストでは、fontspec と 30 個の TikZ 図を含む 33 ページの LuaLaTeX 文書をコンパイルしました。同時コンパイルでは別々のプロジェクトを使用しました。 スワップがないと、1 回のメモリ不足による強制終了が次の強制終了を招きます。web が再起動し、その起動に再びメモリが必要になり、ハードリセットするまでサーバーが応答しなくなります。スワップがあれば、3 件の同時コンパイルでも 1 件とほぼ同じ時間で終わります。スワップに追い出されるのはアイドル状態の Node.js のページだからです。 未テストの項目:Git のクローンとプッシュの負荷、多数のユーザーによる同時編集、低速ディスク上のスワップ(今回のホストは SSD を使用)。

Kubernetes

Kubernetes ガイドではノードのスワップを無効にしているため(ノードの準備)、そこで適用できるのはステップ 2 だけです。NODE_OPTIONS と MALLOC_ARENA_MAX は overleaf-env ConfigMap に設定してください(インスタンスのカスタマイズ)。MongoDB のキャッシュは MongoDB と Redis のデプロイ ですでに設定されています。
最終更新日 2026年11月21日