Langsung ke konten utama
Ayakaleaf Pro dapat berjalan di server dengan 2 inti CPU dan memori 2 GB, termasuk integrasi Git, setelah Anda menambahkan swap 2 GB. Tanpa swap, memorinya habis saat proses mulai. Pengaturan di langkah 2 kemudian memangkas penggunaan swap hampir setengahnya.
Kami mengukur ini pada Ayakaleaf Pro 6.3.1 dengan Toolkit, di mesin virtual QEMU/KVM 2 vCPU / 2 GiB yang menjalankan Ubuntu 24.04, dengan kompilasi sandbox (texlive-basic:2025.1) dan integrasi Git aktif.

Mengapa 2 GB tidak cukup secara default

Saat idle dengan pengaturan default, Ayakaleaf Pro membutuhkan sekitar 1,9 GiB. Ubuntu dan Docker sudah memakai 364 MiB dari mesin 2 GiB, sehingga tersisa sekitar 1600 MiB.

  1. Tambahkan swap 2 GB

Ini langkah yang paling penting.

  1. Kurangi penggunaan memori

Tambahkan baris berikut ke config/variables.env. Container integrasi Git juga membaca file ini.
variables.env
Untuk membatasi cache MongoDB, tambahkan entri mongo di bawah services dalam config/docker-compose.override.yml (file yang sama yang mengatur image Ayakaleaf Pro):
docker-compose.override.yml
Lalu jalankan bin/up -d.
NODE_OPTIONS menggantikan nilai yang diatur di image, jadi baris tersebut harus tetap berisi --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Tanpa keduanya, layanan Node.js tidak dapat memuat paketnya dan tidak akan berjalan. --optimize-for-size tidak dapat digunakan: Node.js menolaknya di NODE_OPTIONS.--replSet overleaf adalah nilai yang diteruskan Toolkit ke MongoDB secara default. Pertahankan.
Dengan heap 160 MiB, meng-clone atau push proyek besar melalui Git dapat kehabisan memori, dan container integrasi Git akan dimulai ulang. Kami tidak mengujinya. Jika itu terjadi, naikkan -Xmx.

Hasil

Setiap pengujian mengompilasi dokumen LuaLaTeX 33 halaman dengan fontspec dan 30 gambar TikZ; kompilasi bersamaan menggunakan proyek yang berbeda. Tanpa swap, satu penghentian karena kehabisan memori memicu penghentian berikutnya: web dimulai ulang, proses mulainya kembali membutuhkan memori, dan server macet hingga reset paksa. Dengan swap, tiga kompilasi sekaligus memakan waktu kurang lebih sama dengan satu kompilasi, karena yang dipindahkan ke swap adalah halaman Node.js yang idle. Tidak diuji: beban clone dan push Git, banyak pengguna yang mengedit bersamaan, dan swap di disk lambat (host kami menggunakan SSD).

Kubernetes

Panduan Kubernetes kami mematikan swap di node (Siapkan node), jadi di sana hanya langkah 2 yang berlaku. Masukkan NODE_OPTIONS dan MALLOC_ARENA_MAX ke ConfigMap overleaf-env (Personalisasi instance Anda). Cache MongoDB sudah diatur di Deploy MongoDB dan Redis.
Terakhir diubah pada 21 November 2026