Passer au contenu principal
Ayakaleaf Pro fonctionne sur un serveur doté de 2 cœurs de processeur et de 2 Go de mémoire, intégration Git comprise, dès que vous ajoutez 2 Go de swap. Sans swap, il manque de mémoire pendant son démarrage. Les réglages de l’étape 2 réduisent ensuite l’utilisation du swap de près de moitié.
Nous avons mesuré cela avec Ayakaleaf Pro 6.3.1 et le Toolkit, dans une machine virtuelle QEMU/KVM 2 vCPU / 2 Gio sous Ubuntu 24.04, avec les compilations en sandbox (texlive-basic:2025.1) et l’intégration Git activées.

Pourquoi 2 Go ne suffisent pas par défaut

Au repos, avec les réglages par défaut, Ayakaleaf Pro a besoin d’environ 1,9 Gio. Ubuntu et Docker utilisent déjà 364 Mio d’une machine de 2 Gio, ce qui laisse environ 1600 Mio.

  1. Ajouter 2 Go de swap

C’est l’étape la plus importante.

  1. Réduire l’utilisation de la mémoire

Ajoutez ces lignes à config/variables.env. Le conteneur de l’intégration Git lit lui aussi ce fichier.
variables.env
Pour plafonner le cache de MongoDB, ajoutez une entrée mongo sous services dans config/docker-compose.override.yml (le fichier qui définit l’image Ayakaleaf Pro) :
docker-compose.override.yml
Exécutez ensuite bin/up -d.
NODE_OPTIONS remplace la valeur définie dans l’image : la ligne doit donc conserver --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Sans ces options, les services Node.js ne peuvent pas charger leurs paquets et ne démarrent pas. --optimize-for-size n’est pas utilisable : Node.js le refuse dans NODE_OPTIONS.--replSet overleaf est ce que le Toolkit transmet à MongoDB par défaut. Conservez-le.
Avec un tas de 160 MiB, cloner ou pousser un gros projet via Git peut épuiser la mémoire, et le conteneur de l’intégration Git redémarre. Nous ne l’avons pas testé. Si cela se produit, augmentez -Xmx.

Résultats

Chaque test compilait un document LuaLaTeX de 33 pages avec fontspec et 30 figures TikZ ; les compilations simultanées portaient sur des projets différents. Sans swap, un arrêt pour manque de mémoire en entraîne un autre : web redémarre, son démarrage a de nouveau besoin de mémoire, et le serveur se bloque jusqu’à une réinitialisation matérielle. Avec du swap, trois compilations simultanées prennent à peu près autant de temps qu’une seule, car ce qui part dans le swap, ce sont des pages Node.js inactives. Non testé : la charge des clones et pushs Git, de nombreux utilisateurs modifiant en même temps, et le swap sur des disques lents (notre hôte utilisait un SSD).

Kubernetes

Notre guide Kubernetes désactive le swap sur les nœuds (Préparer les nœuds), donc seule l’étape 2 s’applique. Placez NODE_OPTIONS et MALLOC_ARENA_MAX dans la ConfigMap overleaf-env (Personnaliser votre instance). Le cache de MongoDB est déjà défini dans Déployer MongoDB et Redis.
Dernière modification le 21 novembre 2026