Skip to main content
Ayakaleaf Pro is a drop-in replacement for the official Overleaf Community Edition, shipped as a Docker image.

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 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.
Here are some recommended hardware configurations for different usage scenarios:

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
We recommend Linux for shared and production servers. You can also run Ayakaleaf Pro on macOS or Windows with WSL 2 using Docker Desktop. Follow the guide for your platform. The images support both AMD64 and ARM64.

LaTeX Performance

LaTeX is a single threaded program, meaning it can only utilize one CPU core at a time. When compiling a single document, performance is primarily limited by the CPU’s single-core clock speed. Therefore the faster the single core performance of your CPU the faster you will be able to compile a document. More CPU cores are only beneficial when multiple users are compiling documents concurrently. Using the ThuThesis template as an example, the compilation time is about 6 seconds on an Intel Core i9-14900K (5.6 GHz), while it takes about 13 seconds on an Azure Standard D2as v5 instance (2 vCPUs, 8 GiB RAM) powered by an AMD EPYC 7763 (3.2 GHz). Of course, actual compilation performance depends on your hardware configuration. Most server CPUs do not run at such high clock speeds as 14900K, so you will need to make a trade-off between cost and compilation speed. Meanwhile, we have also conducted an in-depth analysis of LaTeX compilation performance. If you are interested, please refer to our blog Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).
Last modified on November 21, 2026