Перейти до основного вмісту
Ayakaleaf Pro працює на сервері з 2 ядрами CPU і 2 ГБ пам’яті, разом з інтеграцією з Git, якщо додати 2 ГБ swap. Без swap йому бракує пам’яті під час запуску. Налаштування з кроку 2 потім зменшують використання swap майже вдвічі.
Ми вимірювали це на Ayakaleaf Pro 6.3.1 з Toolkit у віртуальній машині QEMU/KVM з 2 vCPU / 2 ГіБ під Ubuntu 24.04, з увімкненими ізольованою компіляцією (texlive-basic:2025.1) та інтеграцією з Git.

Чому за замовчуванням 2 ГБ недостатньо

У режимі простою з налаштуваннями за замовчуванням Ayakaleaf Pro потребує близько 1,9 ГіБ. Ubuntu і Docker уже займають 364 МіБ на машині з 2 ГіБ, тож залишається близько 1600 МіБ.

  1. Додайте 2 ГБ swap

Це найважливіший крок.

  1. Зменште використання пам’яті

Додайте ці рядки до config/variables.env. Контейнер інтеграції з Git також читає цей файл.
variables.env
Щоб обмежити кеш MongoDB, додайте запис mongo у розділ services файлу config/docker-compose.override.yml (того самого файлу, де задано образ Ayakaleaf Pro):
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 клонування або push великого проєкту через Git може вичерпати пам’ять, і контейнер інтеграції з Git перезапуститься. Ми цього не тестували. Якщо це станеться, збільште -Xmx.

Результати

У кожному тесті компілювався 33-сторінковий документ LuaLaTeX з fontspec і 30 рисунками TikZ; одночасні компіляції виконувалися для різних проєктів. Без swap одне завершення через брак пам’яті тягне за собою наступне: web перезапускається, його запуску знову потрібна пам’ять, і сервер зависає до жорсткого перезавантаження. Зі swap три одночасні компіляції тривають приблизно стільки ж, скільки одна, бо у swap потрапляють неактивні сторінки Node.js. Не тестувалося: навантаження від clone і push у Git, одночасне редагування багатьма користувачами та swap на повільних дисках (наш хост використовував SSD).

Kubernetes

Наш посібник з Kubernetes вимикає swap на вузлах (Підготовка вузлів), тому там застосовується лише крок 2. Помістіть NODE_OPTIONS і MALLOC_ARENA_MAX у ConfigMap overleaf-env (Персоналізація вашого екземпляра). Кеш MongoDB уже задано в розділі Розгортання MongoDB і Redis.
Останнє оновлення 21 листопада 2026 р.