Choose your installation path
Install on Linux
Using Docker Compose on Linux (with Docker)
Install on Windows
Using Docker Compose on Windows (with WSL)
Install on Mac
Using Docker Compose on macOS (Docker Desktop)
Run it on a Kubernetes cluster
Using Kubernetes (experimental)
Run it on a tiny server
For Small server only (needs 2 GB of swap)
Let Claude or Codex do the install
Using Claude or Codex
Try it quickly in the browser
Using GitHub Codespace (minimal TeX Live)
Migrate an existing Overleaf
Migrate from Existing Overleaf instance
Install without internet access
Air-gapped/offline deployments for internal usage
Coming from the official Overleaf Server Pro? (What is the difference?) Open an issue before migrating: templates are stored differently, and we’ll help you for free.
Want to go back to the official Overleaf Community Edition? Set
Want to go back to the official Overleaf Community Edition? Set
SERVER_PRO=false (ayaka-notes Toolkit) or remove the override file (official Toolkit). No data is lost.Hardware requirements
We conducted relevant tests and found that, if you run Overleaf on a 2-core, 2 GB RAM server, its core components—primarily based on Node.js—will consume approximately 1 GB of memory. Redis and MongoDB may require an additional 0.5 GB, while starting a sandboxed Docker container for compilation can consume another 0.3 GB. This means that a 2-core, 2 GB server can realistically handle only about one concurrent compilation at a time.- The minimum hardware requirements for installing Ayakaleaf Pro are a 2-core CPU and 3 GB of RAM.
- Due to the size of our TeX Live image, at least 40 GB of storage is required to enable sandboxed compilation.
- If you want to install the complete set of TeX Live images from 2020 through 2026, please make sure you have at least 150 GB of free disk space available.
Software requirements
For software requirements, we recommend using a recent and stable version of Ubuntu (e.g. Ubuntu 24.04 in 2025–2026, Ubuntu 22.04 in 2023–2024) together with the latest stable version of Docker.Ubuntu 26.04 ships with Linux kernel 7.0, and MongoDB refuses to start on Linux kernel 6.19 through 7.0.13 (details). To run on these kernels, add the following to the
mongo service in overleaf-toolkit/config/docker-compose.override.yml (the same file that sets the Ayakaleaf Pro image). Our CI runs on Ubuntu 26.04 with this setting. Kernel 7.0.14 and later don’t need it.docker-compose.override.yml

