Passer au contenu principal
Ayakaleaf Pro est un remplacement direct de l’Overleaf Community Edition officielle, fourni sous forme d’image Docker.

Choisir votre méthode d’installation

Installer sur Linux

Utiliser Docker Compose sous Linux (avec Docker)

Installer sur Windows

Utiliser Docker Compose sous Windows (avec WSL)

Installer sur Mac

Utiliser Docker Compose sous macOS (Docker Desktop)

L'exécuter sur un cluster Kubernetes

Utiliser Kubernetes (expérimental)

L'exécuter sur un tout petit serveur

Pour les petits serveurs uniquement (nécessite 2 Go de swap)

Laisser Claude ou Codex faire l'installation

Utiliser Claude ou Codex

L'essayer rapidement dans le navigateur

Utiliser GitHub Codespace (TeX Live minimal)

Migrer un Overleaf existant

Migrer depuis une instance Overleaf existante

Installer sans accès à Internet

Déploiements isolés/hors ligne pour un usage interne
Vous venez de l’Overleaf Server Pro officiel ? (Quelle est la différence ?) Ouvrez une issue avant de migrer : les modèles sont stockés différemment, et nous vous aiderons gratuitement.
Vous souhaitez revenir à l’Overleaf Community Edition officielle ? Définissez SERVER_PRO=false (Toolkit ayaka-notes) ou supprimez le fichier de surcharge (Toolkit officiel). Aucune donnée n’est perdue.

Prérequis matériels

Nous avons effectué des tests et constaté que, si vous exécutez Overleaf sur un serveur à 2 cœurs et 2 Go de RAM, ses composants principaux — essentiellement basés sur Node.js — consomment environ 1 Go de mémoire. Redis et MongoDB peuvent nécessiter 0,5 Go supplémentaire, tandis que le démarrage d’un conteneur Docker en sandbox pour la compilation peut consommer encore 0,3 Go. Concrètement, un serveur à 2 cœurs et 2 Go ne peut gérer qu’environ une compilation simultanée.
  • La configuration matérielle minimale pour installer Ayakaleaf Pro est un processeur à 2 cœurs et 3 Go de RAM.
  • En raison de la taille de notre image TeX Live, au moins 40 Go de stockage sont nécessaires pour activer la compilation en sandbox.
  • Si vous souhaitez installer l’ensemble complet des images TeX Live de 2020 à 2026, assurez-vous de disposer d’au moins 150 Go d’espace disque libre.
Voici quelques configurations matérielles recommandées selon les scénarios d’utilisation :

Prérequis logiciels

Côté logiciel, nous recommandons d’utiliser une version récente et stable d’Ubuntu (par ex. Ubuntu 24.04 en 2025–2026, Ubuntu 22.04 en 2023–2024) avec la dernière version stable de Docker.
Ubuntu 26.04 est livré avec le noyau Linux 7.0, et MongoDB refuse de démarrer sur les noyaux Linux 6.19 à 7.0.13 (détails). Pour fonctionner sur ces noyaux, ajoutez ce qui suit au service mongo dans overleaf-toolkit/config/docker-compose.override.yml (le même fichier que celui qui définit l’image Ayakaleaf Pro). Notre CI s’exécute sur Ubuntu 26.04 avec ce paramètre. Les noyaux 7.0.14 et ultérieurs n’en ont pas besoin.
docker-compose.override.yml
Nous recommandons Linux pour les serveurs partagés et de production. Vous pouvez également exécuter Ayakaleaf Pro sur macOS ou sur Windows avec WSL 2 à l’aide de Docker Desktop. Suivez le guide correspondant à votre plateforme. Les images prennent en charge AMD64 et ARM64.

Performances de LaTeX

LaTeX est un programme monothread : il ne peut utiliser qu’un seul cœur de processeur à la fois. Lors de la compilation d’un document, les performances sont principalement limitées par la fréquence monocœur du processeur. Ainsi, plus les performances monocœur de votre processeur sont élevées, plus la compilation d’un document sera rapide. Davantage de cœurs n’est utile que lorsque plusieurs utilisateurs compilent des documents simultanément. En prenant l’exemple du modèle ThuThesis, la compilation prend environ 6 secondes sur un Intel Core i9-14900K (5,6 GHz), contre environ 13 secondes sur une instance Azure Standard D2as v5 (2 vCPU, 8 Gio de RAM) équipée d’un AMD EPYC 7763 (3,2 GHz). Bien entendu, les performances réelles de compilation dépendent de votre configuration matérielle. La plupart des processeurs de serveur ne fonctionnent pas à des fréquences aussi élevées que le 14900K ; vous devrez donc trouver un compromis entre coût et vitesse de compilation. Par ailleurs, nous avons mené une analyse approfondie des performances de compilation LaTeX. Si cela vous intéresse, consultez notre article de blog Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).
Dernière modification le 21 novembre 2026