Langsung ke konten utama

The Doctor

Overleaf Toolkit dilengkapi dengan skrip doctor yang praktis untuk membantu proses debugging. Jalankan bin/doctor dan skrip akan mencetak informasi tentang lingkungan host Anda, konfigurasi Anda, dan dependensi yang dibutuhkan Toolkit. Output ini juga dapat membantu kami mendiagnosis masalah pada instalasi Ayakaleaf Pro Anda.
Pengguna Overleaf Pro dapat membuka issue di GitHub.Sebaiknya sertakan output dari skrip bin/doctor dalam pesan Anda.

Berkonsultasi dengan Doctor

Jalankan skrip doctor:
Run doctor
Anda akan melihat output yang mirip dengan contoh di bawah ini.

Informasi Host

Bagian Host Information berisi informasi tentang mesin yang menjalankan Toolkit (misalnya, distribusi dan rilis Linux).

Dependensi

Bagian Dependencies mencantumkan alat-alat yang dibutuhkan agar Toolkit dapat berfungsi. Jika sebuah alat tersedia, alat tersebut akan dicantumkan sebagai status: present beserta info versinya. Jika tidak ada, alat tersebut akan dicantumkan sebagai status: MISSING! dan sebuah peringatan akan ditambahkan di bagian bawah output doctor.
Jika ada dependensi yang tidak tersedia, Toolkit hampir pasti tidak akan berfungsi.

Konfigurasi

Bagian Configuration berisi informasi tentang file-file di direktori config/. Untuk config/overleaf.rc, doctor mencetak beberapa nilai penting. File yang tidak ada akan dicantumkan sebagai status: MISSING! dan sebuah peringatan akan ditambahkan di bagian bawah output doctor.
Catatan dari contoh di atas:
  • OVERLEAF_DATA_PATH yang diatur ke /tmp/overleaf mungkin bukan lokasi yang aman untuk data penting.
  • MONGO_ENABLED: false berarti Toolkit tidak akan menyediakan MongoDB sendiri; pastikan MONGO_URL mengarah ke MongoDB yang dikelola secara eksternal jika diperlukan.
  • config/variables.env tidak ada dalam contoh tersebut.

Peringatan

Bagian Warnings merangkum masalah yang ditemukan oleh skrip doctor. Jika tidak ada masalah, bagian ini akan menunjukkannya.

Tanya Jawab

Jawaban: Tidak, ketiganya hanya bersifat informatif. bin/doctor hanya mencetak laporan, dan tidak menghentikan bin/up.
  • logged in to quay.io: false dan peringatan Server Pro enabled, but not logged in to quay.io repository: pemeriksaan ini berasal dari Toolkit resmi, di mana image Server Pro berada di registry quay.io privat. Dengan SERVER_PRO=true, Toolkit menarik ghcr.io/ayaka-notes/overleaf-pro, yang bersifat publik, sehingga tidak perlu login. Abaikan peringatan ini.
  • grep: /root/.docker/config.json: No such file or directory (atau direktori home lainnya): pemeriksaan quay.io mencari quay.io di file tersebut. Docker hanya menulis file itu ketika ada pengaturan yang perlu disimpan, misalnya setelah docker login, sehingga file ini tidak ada di banyak server. File ini tidak diperlukan.
  • perl: warning: Setting locale failed: Toolkit hanya menggunakan perl di sini, di bin/doctor, untuk mencetak versinya, dan Perl memberi peringatan ketika LANG atau LC_ALL menyebut locale yang tidak terinstal di host. Versinya tetap dicetak. Untuk menghilangkannya, atur variabel-variabel ini ke locale yang tercantum oleh locale -a, misalnya C.UTF-8.
Peringatan seperti Docker daemon is not running, docker not found, Docker Compose not found, atau file yang hilang di config/ memang perlu diperbaiki: Toolkit tidak dapat berjalan tanpanya.
Terakhir diubah pada 2 November 2026