Langsung ke konten utama
Di bagian ini kita menjalankan Ayakaleaf Pro secara lokal di Windows dengan WSL 2, Ubuntu, Docker Desktop, dan Ayakaleaf Toolkit. Panduan ini menggunakan http://localhost:8080, menyimpan data di direktori home Ubuntu, dan mengaktifkan sandboxed compiles. Aplikasi, MongoDB, Redis, dan TeX Live berjalan di kontainer Linux yang dikelola oleh Docker Desktop. Jalankan perintah Toolkit di Ubuntu; buka aplikasi di browser Windows Anda. Langkah 0 menjelaskan bagaimana bagian Windows dan Linux saling terhubung, dimulai dari menginstal WSL. Anda dapat menggunakan Windows untuk instance lokal atau menjaganya tetap berjalan terus-menerus dengan pengaturan ketersediaan di langkah 6. Untuk server bersama dan server produksi, kami merekomendasikan panduan Linux, dengan HTTPS, backup, dan kontrol akses. Mode tidur Windows, penghentian Docker Desktop, dan penghentian WSL akan menginterupsi instance lokal ini; lihat Menjaga instance tetap tersedia.

Sebelum memulai

Anda memerlukan:
  • Versi Windows dan prosesor yang didukung oleh Docker Desktop for Windows, dengan virtualisasi hardware diaktifkan. Panduan ini menggunakan Windows 11 di x86-64.
  • Izin untuk mengaktifkan WSL dan menginstal perangkat lunak. WSL harus versi 2.1.5 atau lebih baru, dengan Ubuntu berjalan dalam mode WSL 2.
  • Memori yang cukup untuk Windows dan kontainer. Untuk instance lokal kecil, 4 CPU dan memori 8 GB yang tersedia untuk Docker adalah titik awal yang disarankan, bukan batas minimum hasil pengukuran.
  • Ruang penyimpanan kosong di disk Windows yang menyimpan data WSL dan Docker. Sediakan minimal 40 GB untuk penyiapan TeX Live lengkap ditambah data proyek; image basic di langkah 5 lebih kecil dan cocok untuk uji deployment awal. Versi image tambahan membutuhkan ruang tambahan.
  • Akses jaringan ke GitHub, GitHub Container Registry (ghcr.io), dan Docker Hub untuk meng-clone Toolkit dan mengunduh image.
Blok PowerShell dijalankan di Windows. Blok Bash dan perintah bin/ dijalankan di Ubuntu kecuali dinyatakan lain. Jangan menjalankan skrip Toolkit di PowerShell atau Git Bash Windows.

Langkah-langkah

0. Menyiapkan WSL 2 dan Docker Desktop

1. Mengunduh Toolkit

2. Kenali Toolkit

3. Inisialisasi konfigurasi

4. Dapatkan Image Ayakaleaf Pro

5. Menyesuaikan instance Anda

6. Tugas pasca-instalasi

Terakhir diubah pada 8 November 2026