Saltar al contenido principal
Ayakaleaf Pro funciona en un servidor con 2 núcleos de CPU y 2 GB de memoria, integración con Git incluida, en cuanto añades 2 GB de swap. Sin swap, se queda sin memoria mientras arranca. Los ajustes del paso 2 reducen además el uso de swap casi a la mitad.
Lo medimos con Ayakaleaf Pro 6.3.1 y el Toolkit, en una máquina virtual QEMU/KVM de 2 vCPU / 2 GiB con Ubuntu 24.04, con compilaciones en sandbox (texlive-basic:2025.1) y la integración con Git activadas.

Por qué 2 GB no bastan de forma predeterminada

En reposo, con la configuración predeterminada, Ayakaleaf Pro necesita unos 1,9 GiB. Ubuntu y Docker ya usan 364 MiB de una máquina de 2 GiB, lo que deja unos 1600 MiB.

  1. Añadir 2 GB de swap

Este es el paso más importante.

  1. Reducir el uso de memoria

Añade estas líneas a config/variables.env. El contenedor de la integración con Git también lee este archivo.
variables.env
Para limitar la caché de MongoDB, añade una entrada mongo en services dentro de config/docker-compose.override.yml (el mismo archivo que define la imagen de Ayakaleaf Pro):
docker-compose.override.yml
Después, ejecuta bin/up -d.
NODE_OPTIONS sustituye el valor definido en la imagen, así que la línea debe conservar --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Sin ellos, los servicios de Node.js no pueden cargar sus paquetes y no arrancan. No se puede usar --optimize-for-size: Node.js lo rechaza en NODE_OPTIONS.--replSet overleaf es lo que el Toolkit pasa a MongoDB de forma predeterminada. Consérvalo.
Con un heap de 160 MiB, clonar o hacer push de un proyecto grande por Git puede agotar la memoria, y el contenedor de la integración con Git se reinicia. No lo hemos probado. Si ocurre, aumenta -Xmx.

Resultados

Cada prueba compiló un documento LuaLaTeX de 33 páginas con fontspec y 30 figuras TikZ; las compilaciones simultáneas eran de proyectos distintos. Sin swap, una terminación por falta de memoria provoca la siguiente: web se reinicia, su arranque vuelve a necesitar memoria y el servidor se cuelga hasta un reinicio forzado. Con swap, tres compilaciones a la vez tardan más o menos lo mismo que una, porque lo que pasa a swap son páginas inactivas de Node.js. No probado: la carga de clones y push de Git, muchos usuarios editando a la vez y swap en discos lentos (nuestro host usaba un SSD).

Kubernetes

Nuestra guía de Kubernetes desactiva el swap en los nodos (Preparar los nodos), así que allí solo se aplica el paso 2. Pon NODE_OPTIONS y MALLOC_ARENA_MAX en el ConfigMap overleaf-env (Personalizar tu instancia). La caché de MongoDB ya está configurada en Desplegar MongoDB y Redis.
Última modificación el 21 de noviembre de 2026