Langsung ke konten utama
Di sini, kami telah mengumpulkan jawaban atas beberapa pertanyaan yang sering diajukan tentang Ayakaleaf Pro.

Pertanyaan Dasar

Tidak. Ayakaleaf Pro sepenuhnya gratis untuk digunakan. Ini bukan uji coba dan tidak memerlukan lisensi.
Ya. Ayakaleaf Pro menyertakan semua fitur Overleaf Server Pro, termasuk integrasi Git-Bridge. Ayakaleaf Pro juga menyertakan fitur-fitur pilihan dari platform SaaS Overleaf. Kami terus mengembangkan dan menyempurnakan Ayakaleaf Pro.
Overleaf Server Pro berbiaya sekitar $300 per pengguna setiap tahun. Diperlukan minimal 10 lisensi, sehingga penerapan dimulai dari kira-kira $3.000 per tahun. Kontrak publik AS yang lebih kecil menunjukkan biaya tahunan sekitar $320–$370 per pengguna. Hal ini membuat Server Pro mahal, terutama bagi tim yang lebih kecil. Lihat #information-and-price-about-overleaf-server-pro untuk pembelian dan harga yang terdokumentasi.
Overleaf Server Pro umumnya digunakan oleh organisasi pemerintah. Mereka menerapkannya di jaringan privat dan mengontrol akses secara ketat. Untuk melindungi data sensitif, fitur-fitur yang disertakan menghindari pertukaran data dengan layanan pihak ketiga. Jika Anda memerlukan GitHub Sync, AI, atau fitur terhubung serupa, Overleaf menyarankan berlangganan platform SaaS-nya.
Ayakaleaf Pro bersifat open source. Kami meninjau kode dengan alat seperti Codex Security untuk memperkuat keamanan dan keandalannya. Jika Anda tidak mengaktifkan sinkronisasi data pihak ketiga, data Anda tetap berada di server Anda. Ayakaleaf Pro tidak berisi telemetri yang mengirim data Anda ke tempat lain.
Kami akan berupaya sebaik mungkin untuk memelihara proyek ini dalam jangka panjang.
Ayakaleaf Pro adalah fork komunitas. Kode dan fitur terintegrasinya berasal dari kontribusi komunitas. Proyek ini dilisensikan di bawah AGPL v3. Penerapan dapat mematuhi lisensi ini apabila memenuhi persyaratannya.
Proyek ini awalnya bernama Overleaf Pro pada tahun 2024. Pengembangan sempat terhenti, lalu dimulai kembali pada akhir 2025. Pada kuartal pertama 2026, Overleaf mengganti nama paket langganan berkemampuan AI miliknya menjadi Pro. Masukan dari komunitas juga mencatat bahwa nama Overleaf Pro dapat menimbulkan risiko merek dagang dan peniruan identitas. Nama tersebut dapat membuat pengguna mengira proyek ini resmi.Kami mengganti nama proyek menjadi Ayakaleaf Pro untuk menghindari kebingungan tersebut. Nama ini dapat dibaca sebagai “Ayaka-notes Overleaf Pro.” Pengelola proyek (Anda bisa memanggil saya ayaka!) telah berkontribusi pada pengembangan komunitas Overleaf sejak masa kuliahnya, lebih dari lima tahun yang lalu. Pengalaman ini mendukung komitmen kami terhadap pemeliharaan jangka panjang.
Sejak 2026, komunitas open source telah merilis banyak editor LaTeX yang dibangun dengan AI, termasuk OpenAI Prism. Ayakaleaf Pro menyimpan data dan layanan Anda di server Anda sendiri. Ini memberi Anda kendali langsung atas penerapan dan data Anda.Banyak editor komunitas eksperimental tidak memiliki rencana pemeliharaan jangka panjang yang mapan. Platform kompilasi LaTeX pihak ketiga juga dapat berhenti beroperasi ketika basis pengguna atau pendapatannya tidak mencukupi. Ayakaleaf Pro menyediakan seluruh kode sumber dan memungkinkan Anda meng-host sendiri setiap layanan. Bahkan jika pemeliharaan dihentikan, layanan self-hosted Anda yang sudah ada dapat terus berjalan.
Repositori tersebut diganti namanya menjadi ayaka-notes/ayakaleaf-pro seiring dengan perubahan nama proyek (lihat Q08). Repositori ini tidak diarsipkan atau diganti: ini adalah repositori yang sama, dan GitHub mengalihkan tautan serta Git remote lama ayaka-notes/overleaf-pro ke nama baru. Image Docker tetap mempertahankan namanya, ghcr.io/ayaka-notes/overleaf-pro, sehingga Anda tidak perlu mengubah config/overleaf.rc atau config/version.

Fitur

Silakan periksa dokumentasi kami untuk daftar fitur terkini. Jika ada fitur yang ingin Anda tambahkan, jangan ragu untuk membuka issue (untuk permintaan fitur) di GitHub. Kami akan berupaya sebaik mungkin untuk mengimplementasikan fitur yang diminta, tetapi pengembangan membutuhkan waktu, dan kami tidak dapat menjamin bahwa setiap fitur akan segera tersedia.
Kontribusi sangat diterima, tetapi penerimaannya tidak dijamin. Kami mengevaluasi setiap PR berdasarkan dampaknya terhadap basis kode Overleaf yang mendasarinya, beban pemeliharaannya, dan nilai yang dibawanya bagi pengguna. Kami akan berupaya sebaik mungkin untuk menggabungkan dan memelihara kontribusi yang bernilai.Namun, kami dapat menolak PR yang memperkenalkan perubahan berlebihan, berisi kode hasil AI yang tidak ditinjau atau kurang dipahami (“vibe coding”), atau menambahkan fitur yang akan sulit dipelihara dalam jangka panjang.
Kami umumnya memperbarui dokumentasi setiap kali merilis fitur baru. Silakan merujuk ke dokumentasi yang relevan untuk petunjuk penyiapan terperinci dan penjelasan tentang variabel lingkungan yang tersedia.
Python Runner menjalankan Python di browser pengguna dengan Pyodide 0.29.3, bukan di server. Python Runner memuat paket yang diimpor oleh kode Anda dari paket bawaan Pyodide, seperti NumPy, pandas, dan Matplotlib. Paket yang diinstal dengan pip dan paket lainnya tidak tersedia. Tidak ada yang perlu dikonfigurasi di server.
Tidak. Pemeriksa ejaan tidak memiliki kamus untuk bahasa Jepang atau Mandarin, sehingga bahasa-bahasa ini tidak ada dalam daftar bahasa pemeriksaan ejaan. Pengguna dapat menonaktifkan pemeriksaan ejaan untuk sebuah proyek di pengaturan editor.Agar sebuah kata tidak lagi ditandai sebagai salah eja, klik kanan kata tersebut dan pilih Add to dictionary. Kata yang ditambahkan disimpan ke akun Anda dan berlaku untuk semua proyek Anda. Untuk meninjau atau menghapusnya, buka pengaturan editor, lalu Spelling and language → Dictionary → Edit. Menambahkan kata tidak menambahkan bahasa pemeriksaan ejaan baru.
Tidak ada penginstal plugin. Fitur-fitur merupakan modul di services/web/modules pada kode sumber, yang dibangun ke dalam image Docker dan diaktifkan melalui pengaturan dalam dokumentasi ini. Untuk menambahkan fitur Anda sendiri, tambahkan modul ke kode sumber dan bangun image Anda sendiri.

Penerapan

Bagi sebagian besar pengguna, kami menyarankan penerapan menggunakan Toolkit. Dukungan Kubernetes masih bersifat eksperimental: Menggunakan Kubernetes menampilkan manifest yang telah kami uji dengan satu atau beberapa replika, tetapi sebuah klaster menambah kompleksitas operasional dan upaya pemeliharaan. Sandboxed Compiles membuat kontainer kompilasinya melalui socket Docker, sehingga setiap node yang menjalankan Ayakaleaf Pro memerlukan Docker Engine. Kami tidak menyediakan konfigurasi CRI-O, Podman, atau Quadlet.
Silakan merujuk ke panduan penskalaan horizontal kami. Anda dapat menerapkan beberapa instans Overleaf dan mengonfigurasi load balancer untuk mendistribusikan lalu lintas di antara instans-instans tersebut.
Jika Anda memiliki instans Overleaf Server Pro yang sudah ada, kami dengan senang hati akan membantu Anda bermigrasi ke Ayakaleaf Pro. Silakan hubungi kami melalui email atau issue.
Tidak. Ayakaleaf Pro harus disajikan dari root sebuah domain. Gunakan domain atau subdomain khusus, seperti https://overleaf.example.com.
Ya. Toolkit berjalan di Linux, macOS dengan Docker Desktop, dan Windows dengan WSL 2 dan Docker Desktop. Kami menyarankan Linux untuk server bersama dan server produksi. Panduan macOS dan Windows menyertakan penyiapan sandboxed compiles.Kami tidak menyediakan docker-compose.yml mandiri. Untuk melihat konfigurasi Compose yang digunakan oleh Toolkit, jalankan bin/docker-compose config di direktori Toolkit.
Tidak ada skrip uninstall. Di direktori Toolkit:
  1. Hentikan dan hapus kontainer dengan bin/docker-compose down.
  2. Hapus data. Secara default, data berada di direktori data/ milik Toolkit. Jika Anda mengubah OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH, atau GIT_BRIDGE_DATA_PATH di config/overleaf.rc, hapus juga direktori-direktori tersebut. Tindakan ini tidak dapat dibatalkan, jadi cadangkan terlebih dahulu jika Anda mungkin memerlukan datanya.
  3. Hapus direktori Toolkit.
  4. Hapus image Docker, yang dapat Anda lihat daftarnya dengan docker images: ghcr.io/ayaka-notes/overleaf-pro, image git-bridge, mongo, redis, dan image TeX Live.
Jalankan perintah berikut di direktori Toolkit:
  • bin/stop menghentikan semua kontainer, bin/start menjalankannya kembali. Kontainer tetap disimpan, sehingga pengguna tetap login.
  • bin/up -d membuat kontainer dan menjalankannya di latar belakang. Jalankan setelah mengubah config/variables.env, config/overleaf.rc, atau config/version: perintah ini membuat ulang kontainer yang konfigurasinya berubah, dan barulah perubahan tersebut berlaku. bin/stop dan bin/start tidak menerapkannya.
  • bin/docker-compose restart sharelatex hanya memulai ulang kontainer Overleaf, tanpa menerapkan perubahan konfigurasi.
Jika pengguna logout setiap kali bin/up membuat ulang kontainer, atur OVERLEAF_SESSION_SECRET, lihat Tanya Jawab di Variabel Lingkungan.
Di aplikasi yang Anda buat di penyedia, bukan di Ayakaleaf Pro. Tidak ada pengaturan callback di config/variables.env untuk integrasi mana pun: Ayakaleaf Pro membangun setiap URL callback dari OVERLEAF_SITE_URL dan mengirimkannya ke penyedia, yang akan menolaknya kecuali cocok dengan yang terdaftar untuk aplikasi tersebut. Jadi Anda hanya perlu mendaftarkannya di penyedia, dan mengatur OVERLEAF_SITE_URL ke alamat yang dibuka pengguna.Jika Anda mengubah OVERLEAF_SITE_URL, misalnya ke domain baru, perbarui juga URL di setiap penyedia, jika tidak penautan akan gagal.
Secara default, semuanya tetap berada di disk lokal server, di direktori data/ milik Toolkit: data/overleaf (file proyek, riwayat, dan output kompilasi), data/mongo, dan data/redis. Untuk instans dengan kurang dari 1000 pengguna, disk lokal dengan cadangan rutin adalah yang kami rekomendasikan.Image Ayakaleaf Pro berukuran sekitar 5 GB. Batas minimum 40 GB di Pendahuluan ditujukan untuk Sandboxed Compiles, yang image texlive-full-nya masing-masing berukuran sekitar 28 GB. Tanpa Sandboxed Compiles, kompilasi berjalan di dalam kontainer sharelatex dengan skema dasar TeX Live ditambah latexmk, texcount, synctex, etoolbox, dan xetex, sehingga banyak proyek gagal karena paket yang hilang. Direktori data/ kemudian bertambah besar seiring proyek Anda dan riwayatnya; periksa dengan du -sh data/*.
Ya, asalkan Windows tetap aktif dan Docker Desktop tetap berjalan. Aktifkan Start Docker Desktop when you sign in to your computer, pertahankan policy restart: always milik Toolkit, dan nonaktifkan mode tidur serta hibernasi otomatis saat terhubung ke daya listrik. Layar boleh mati; perilaku lid laptop adalah pengaturan terpisah. Menutup terminal Ubuntu setelah bin/up -d tidak menghentikan kontainer yang berjalan di latar belakang. Menutup Docker Desktop, menjeda engine-nya, atau menjalankan wsl --shutdown akan menginterupsi layanan.Resource Saver Docker Desktop berbeda dari mode tidur Windows: fitur ini berlaku saat tidak ada kontainer yang berjalan, sehingga stack Ayakaleaf yang sedang berjalan tidak dianggap idle hanya karena tidak ada yang sedang mengedit. Setelah Windows di-reboot, pengaturan startup saat login tetap mengharuskan seseorang untuk login. Ikuti Menjaga instance tetap tersedia untuk pemeriksaan dan langkah pemulihan. Linux tetap menjadi rekomendasi kami jika ketersediaan tidak boleh bergantung pada login desktop interaktif.
Panduan ini menggunakan backend WSL 2. Backend ini memerlukan virtualisasi CPU yang diaktifkan di BIOS/UEFI, fitur Virtual Machine Platform Windows, dan instalasi WSL 2 yang berfungsi. Fitur Hyper-V lengkap adalah backend Docker Desktop terpisah dan bukan prasyarat untuk penyiapan WSL ini.Periksa Task Manager → Performance → CPU → Virtualization dan wsl --list --verbose di PowerShell. Error seperti 0x80370102 dapat berarti virtualisasi, fitur Windows, atau hypervisor boot dinonaktifkan. Lihat langkah pemecahan masalah instalasi Windows, beserta tautan perbaikan dari Microsoft dan Docker. Restart Windows setelah mengaktifkan fitur yang diperlukan; menginstal ulang Ayakaleaf tidak dapat memperbaiki engine Docker yang tidak mau berjalan.

LaTeX

Saat Anda mengaktifkan Sandbox Compiles, kompilasi setiap pengguna berjalan di kontainer Docker terpisah dan terisolasi dari kompilasi pengguna lain. Shell Escape diaktifkan secara default untuk Sandbox Compiles.
Kami telah menyempurnakan image TeX Live Full kami untuk Sandbox Compiles selama tiga tahun terakhir. Dalam sebagian besar kasus, proyek yang berhasil dikompilasi di overleaf.com juga dapat dikompilasi dengan benar menggunakan Ayakaleaf Pro. Jika font yang diperlukan tidak tersedia, unggah font tersebut ke proyek Anda secara manual.
Silakan unggah proyek Anda ke situs web resmi Overleaf, aktifkan berbagi tautan hanya-baca, dan sertakan tautan tersebut dalam issue GitHub.Kami akan menyelidiki dan memperbaiki bug apa pun yang mencegah proyek dikompilasi di Ayakaleaf Pro jika proyek tersebut berhasil dikompilasi di situs web resmi Overleaf. Masalah kompilasi di luar cakupan ini tidak termasuk dalam dukungan kami.
Terakhir diubah pada 8 November 2026