Calibre Web : Percobaan Install di Cpanel tanpa akses Terminal (Gagal)

Dalam proses instalasi Calibre Web di cPanel, terdapat beberapa kendala yang menyebabkan instalasi tidak berhasil. Dokumentasi ini bertujuan untuk menjelaskan masalah yang muncul dan kemungkinan penyebabnya.

Proses Instalasi

Langkah-langkah yang diikuti dalam instalasi:

1. Mengunggah file Calibre Web ke direktori /home/username/public_html/pustaka/.
2. Membuat virtual environment menggunakan Python 3.12.
3. Menginstal dependensi dari requirements.txt.
4. Membuat file konfigurasi passenger_wsgi.py.
5. Mengatur izin file metadata.db menjadi 777.
6. Mengakses Calibre Web melalui URL: http://inibudi.or.id/pustaka.

Masalah yang Ditemui

1. No such application (or application not configured) "public_html/inibudi.or.id/pustaka"

  Pesan ini muncul ketika mencoba menjalankan aplikasi. Penyebab kemungkinan:  
  * File passenger_wsgi.py tidak terbaca oleh Passenger.  
  * Virtual environment tidak terdeteksi.  

2. 503 Service Unavailable

  Aplikasi gagal dimuat dan server menampilkan pesan ini. Penyebab kemungkinan:  
  * Dependensi Python tidak terinstal dengan benar.  
  * Path virtual environment salah atau tidak terdeteksi oleh Passenger.  

3. Munculnya file app.db

  Calibre Web membuat file app.db, meskipun seharusnya menggunakan metadata.db.  
  Ini menunjukkan bahwa Calibre Web tidak menemukan database yang benar dan membuat database baru.

Penyebab Kegagalan

Beberapa kemungkinan penyebab kegagalan instalasi:

• Keterbatasan cPanel dalam menjalankan aplikasi berbasis WSGI.
• Kesulitan mendeteksi virtual environment di cPanel.
• Konflik antara versi Python yang digunakan dan dependensi Calibre Web.
• Konfigurasi file passenger_wsgi.py tidak sesuai.

Alternatif Solusi

Jika instalasi Calibre Web di cPanel terus mengalami kegagalan, beberapa alternatif yang bisa dipertimbangkan:

• Gunakan VPS untuk instalasi yang lebih fleksibel.
• Gunakan Docker, yang lebih mudah untuk mengatur dependensi dan lingkungan aplikasi.
• Gunakan Kavita atau Ubooquity sebagai alternatif untuk perpustakaan digital dengan dukungan OPDS.
• Jika ingin yang lebih ringan di server dan menggunakan PHP 7.4 bisa menggunakan COPS seperti yang dijelaskan.

Kesimpulan

Instalasi Calibre Web di cPanel yang tidak ada akses ke terminal bisa menjadi tantangan karena keterbatasan platform tersebut. Jika Anda tetap ingin menggunakan Calibre Web, sebaiknya pertimbangkan untuk berpindah ke VPS atau solusi hosting yang mendukung Python dan WSGI dengan lebih baik. Namun jika ingin menggunakan cPanel biasa anda bisa menggunakan COPS.