Server Solusi – Website yang dikelola melalui CyberPanel bisa menampilkan pesan 503 Service Unavailable meskipun domain masih mengarah ke VPS dan koneksi ke server terlihat normal. Dalam kondisi ini, pengunjung tidak bisa mengakses halaman seperti biasa, sementara penyebabnya belum tentu berasal dari konfigurasi domain atau SSL.

Pada instalasi CyberPanel yang menggunakan OpenLiteSpeed, error 503 dapat berkaitan dengan proses PHP yang tidak berjalan, backend aplikasi yang tidak merespons, batas resource yang tercapai, atau masalah pada konfigurasi web server. Jika website menggunakan WordPress atau Laravel, masalah di sisi aplikasi juga perlu diperiksa.

Saya tidak memiliki log atau kronologi dari server yang mengalami masalah ini, jadi penyebab pastinya belum bisa ditentukan. Untuk menghindari perubahan konfigurasi yang tidak perlu, panduan ini menggunakan pendekatan diagnosis bertahap agar kamu bisa mengidentifikasi sumber error sebelum menerapkan perbaikan.

Mengapa Website CyberPanel Mengalami Error 503?

Cara mengatasi CyberPanel website error 503 Service Unavailable adalah memeriksa status OpenLiteSpeed, membaca error log pada waktu kejadian, lalu memastikan proses PHP atau backend aplikasi berjalan dengan baik. Jika log menunjukkan kegagalan LSAPI, periksa proses PHP dan konfigurasi handler. Jika ditemukan kehabisan resource, cari proses atau batas kapasitas yang menjadi penyebabnya.

Jangan langsung restart VPS atau mengubah permission seluruh direktori website. Mulailah dengan pemeriksaan yang tidak mengubah kondisi server, karena pesan 503 hanya menunjukkan bahwa layanan tidak dapat memenuhi permintaan saat itu, bukan satu penyebab teknis tertentu.

Gejala dan Kemungkinan Penyebab Error 503

Error 503 di CyberPanel bisa berasal dari beberapa lapisan layanan. Cara membedakannya adalah melihat apakah semua website terdampak, apakah hanya satu domain yang bermasalah, dan apa yang tercatat di log saat permintaan gagal.

Tabel tersebut merupakan petunjuk diagnosis, bukan kepastian penyebab. Pesan error yang tercatat pada waktu kejadian tetap menjadi dasar utama untuk menentukan tindakan.

Baca JugaCyberPanel Database Connection Failed: Penyebab dan Cara Mengatasinya

Perbedaan error 503 pada website dan panel CyberPanel

Pastikan juga lokasi error yang kamu lihat. Jika domain website menampilkan 503, pemeriksaan awal berfokus pada OpenLiteSpeed, PHP, dan aplikasi website. Jika halaman administrasi CyberPanel di port 8090 yang gagal, service panel seperti lscpd dan log CyberPanel juga perlu diperiksa.

Keduanya merupakan jalur layanan yang berbeda. Restart service panel tidak otomatis memperbaiki website yang dilayani OpenLiteSpeed.

Proses Diagnosis Error 503 di CyberPanel

Langkah berikut mengasumsikan CyberPanel berjalan di Linux dengan OpenLiteSpeed dan kamu memiliki akses SSH dengan hak sudo. Nama service atau lokasi log bisa berbeda pada instalasi tertentu.

1. Periksa status OpenLiteSpeed

Jalankan:

sudo systemctl status lsws --no-pager -l

Pada instalasi CyberPanel standar, service OpenLiteSpeed umumnya bernama lsws.

Perhatikan apakah statusnya active (running), failed, atau tidak aktif. Status aktif belum menjamin PHP dapat memproses permintaan, tetapi jika service gagal berjalan, itulah jalur diagnosis pertama.

Kemudian baca error log utama:

sudo tail -n 100 /usr/local/lsws/logs/error.log

Log ini dapat menunjukkan kegagalan membuka listener, masalah koneksi ke PHP, kegagalan proses, atau error lainnya. Cari pesan yang berdekatan dengan waktu kamu mengakses website.

Untuk memantau log secara langsung saat menguji website, gunakan:

sudo tail -f /usr/local/lsws/logs/error.log

Buka website di tab browser lain, lalu amati pesan baru yang muncul. Tekan Ctrl+C untuk menghentikan pemantauan.

Jika log utama tidak menjelaskan masalah, periksa juga log khusus virtual host atau log aplikasi. Lokasinya bergantung pada konfigurasi website. Dokumentasi CyberPanel mencantumkan /usr/local/lsws/logs/error.log sebagai lokasi log error web server.

2. Periksa proses PHP dan LSAPI

OpenLiteSpeed menggunakan mekanisme eksternal untuk menjalankan PHP, yang umumnya dikenal sebagai LiteSpeed API atau LSAPI. Jika proses PHP gagal dimulai, kehabisan resource, atau tidak bisa menerima permintaan, website dinamis dapat mengembalikan 503.

Periksa proses PHP:

ps aux | grep '[l]sphp'

Perintah tersebut membantu melihat proses lsphp yang sedang berjalan. Namun, jumlah proses yang sedikit atau tidak terlihat sesaat belum cukup untuk menyimpulkan bahwa PHP rusak karena proses dapat dibuat sesuai kebutuhan.

Baca JugaCara Mengatasi CyberPanel DNS Tidak Berfungsi

Selanjutnya, cari petunjuk terkait LSAPI pada error log:

sudo grep -Ei 'lsapi|lsphp|503|fork|memory|timeout|socket' \/usr/local/lsws/logs/error.log | tail -n 100

Beberapa petunjuk yang perlu diperhatikan:

• Cannot allocate memory: proses mungkin tidak memperoleh memori yang diperlukan.

• fork() failed: pembuatan proses gagal, misalnya karena keterbatasan resource atau batas proses.

• connection ... failed: periksa koneksi ke backend PHP atau socket yang dikonfigurasi.

• timeout: proses PHP atau backend mungkin tidak merespons dalam waktu yang ditentukan.

Pesan-pesan tersebut merupakan contoh pola error yang mungkin ditemukan, bukan output aktual dari server kamu. Dokumentasi LiteSpeed membahas hubungan antara error 503, PHP, LSAPI, dan keterbatasan resource.

3. Periksa RAM, CPU, dan kapasitas disk

Jangan mengabaikan resource server, terutama jika error muncul ketika trafik meningkat atau saat proses backup dan cron berjalan.

Periksa memori:

free -h

Lihat kolom available untuk memperkirakan memori yang masih dapat digunakan tanpa harus bergantung pada swap. RAM yang hampir penuh bisa menjadi petunjuk, tetapi angka penggunaan RAM yang tinggi saja belum membuktikan adanya masalah.

Periksa beban CPU dan proses aktif:

top

Perhatikan proses yang menggunakan CPU atau memori secara berlebihan. Jika error muncul secara berkala, bandingkan kondisi saat website normal dengan saat 503 terjadi.

Periksa kapasitas filesystem:

df -h

Jika partisi yang menampung log, file sementara, atau data aplikasi sudah penuh, layanan dapat mengalami masalah tambahan. Periksa juga inode apabila ada indikasi kegagalan membuat file:

df -i

Jika RAM, CPU, atau disk menjadi penyebab yang mungkin, cari proses dan penggunaan yang mendasarinya. Jangan langsung menambah batas proses PHP karena itu bisa memperbesar tekanan memori pada VPS.

4. Periksa log aplikasi website

Jika hanya satu website yang menampilkan 503, lanjutkan pemeriksaan pada aplikasi tersebut.

Untuk WordPress, perhatikan error PHP dan perubahan plugin atau tema terbaru. Untuk Laravel, periksa file log di direktori storage/logs pada instalasi yang bersangkutan, jika logging aplikasi dikonfigurasi menggunakan lokasi standar Laravel.

Baca JugaWebsite CyberPanel Menampilkan 403 Forbidden: Penyebab dan Cara Mengatasinya

Contoh perintah untuk membaca log Laravel:

tail -n 100 /path/ke/aplikasi/storage/logs/laravel.log

Ganti /path/ke/aplikasi dengan lokasi aplikasi yang sebenarnya. File laravel.log juga bisa tidak ada atau memiliki nama berbeda sesuai konfigurasi logging.

Cari exception, kegagalan koneksi database, timeout, atau error yang muncul pada waktu yang sama dengan 503. Jika aplikasi menghasilkan error fatal, perbaiki masalah aplikasi berdasarkan pesan yang ditemukan, bukan dengan mengubah konfigurasi OpenLiteSpeed secara acak.

5. Pastikan konfigurasi PHP website sesuai

CyberPanel memungkinkan website menggunakan versi PHP tertentu. Jika error muncul setelah mengganti versi PHP atau memperbarui server, periksa apakah handler PHP yang digunakan website masih mengarah ke binary yang tersedia.

Di CyberPanel, buka pengaturan website yang bermasalah dan periksa pilihan versi PHP. Bandingkan dengan konfigurasi external application dan script handler OpenLiteSpeed jika kamu mengelolanya secara manual.

Dokumentasi OpenLiteSpeed menjelaskan bahwa external application bertipe LSAPI harus menggunakan command PHP yang valid dan terhubung dengan script handler yang sesuai.

Jangan langsung mengganti versi PHP ke versi terbaru. Aplikasi lama bisa membutuhkan ekstensi atau perilaku PHP tertentu. Pastikan juga bahwa versi PHP yang dipilih benar-benar terpasang dan didukung oleh aplikasi.

Langkah Perbaikan Berdasarkan Hasil Diagnosis

Setelah pemeriksaan di atas, gunakan solusi yang sesuai dengan temuan. Berikut urutan tindakan yang relatif aman, mulai dari perubahan paling kecil.

1. Jika OpenLiteSpeed berhenti atau gagal berjalan

Periksa terlebih dahulu log error terbaru:

sudo tail -n 100 /usr/local/lsws/logs/error.log

Jika ditemukan kesalahan konfigurasi atau kegagalan binary, tangani penyebab tersebut terlebih dahulu. Pada instalasi OpenLiteSpeed yang mendukung perintah ini, kamu dapat menguji konfigurasi menggunakan:

sudo /usr/local/lsws/bin/openlitespeed -t

Jika pengujian gagal, jangan langsung melakukan restart. Periksa pesan yang ditampilkan dan perbaiki masalahnya terlebih dahulu.

Jika konfigurasi valid dan tidak ada indikasi masalah lain, restart service dapat dipertimbangkan:

sudo systemctl restart lsws

Perhatian: restart dapat memutus koneksi aktif dan menyebabkan gangguan singkat pada semua website yang dilayani service tersebut. Lakukan pada waktu yang sesuai jika server menangani website produksi.

Baca JugaCara Mengatasi CyberPanel SSL Tidak Bisa Diperpanjang

Setelah itu, periksa status:

sudo systemctl status lsws --no-pager -l

Jika service aktif tetapi 503 masih terjadi, lanjutkan ke pemeriksaan PHP dan aplikasi. Restart web server saja tidak menyelesaikan semua jenis error 503.

2. Jika proses PHP mengalami kegagalan

Jika log menunjukkan masalah LSAPI atau lsphp, periksa versi PHP, command handler, serta konfigurasi external application yang digunakan website.

Langkah perbaikannya dapat mencakup:

1. Memastikan binary PHP yang ditetapkan memang tersedia.

2. Memeriksa konfigurasi socket atau alamat external application.

3. Memastikan handler untuk file PHP mengarah ke external application yang benar.

4. Memeriksa apakah batas proses atau koneksi sudah tercapai.

5. Memulai ulang proses atau service terkait sesuai mekanisme yang didukung instalasi.

Jangan mengasumsikan bahwa semua instalasi CyberPanel memiliki nama service PHP terpisah yang sama. Cara pengelolaan proses PHP bergantung pada versi, konfigurasi, dan handler yang digunakan.

Jika perlu mengubah konfigurasi LSAPI, simpan salinan konfigurasi sebelumnya dan catat nilai awalnya. Ubah hanya parameter yang relevan dengan bukti di log. Menaikkan jumlah worker tanpa memperhitungkan RAM bisa membuat server semakin terbebani.

3. Jika RAM atau resource server tidak mencukupi

Jika ditemukan Cannot allocate memory atau kegagalan pembuatan proses, periksa proses yang menggunakan resource paling banyak dan cari penyebabnya.

Pada Linux, kamu bisa memeriksa apakah kernel mencatat proses yang dihentikan karena kehabisan memori:

sudo journalctl -k --since "1 hour ago" --no-pager

Perhatikan pesan yang berhubungan dengan Out of memory atau Killed process.

Jika penyebabnya adalah aplikasi yang menggunakan terlalu banyak resource, optimalkan query database, periksa cron yang berjalan bersamaan, dan tinjau proses PHP yang menumpuk. Penambahan RAM atau perubahan batas proses bisa menjadi opsi, tetapi keputusan tersebut sebaiknya didasarkan pada pengukuran penggunaan server.

Hindari menjalankan perintah untuk menghentikan semua proses PHP secara massal. Tindakan tersebut berpotensi mengganggu seluruh website yang berjalan pada server.

4. Jika error hanya terjadi pada WordPress atau Laravel

Jika website lain tetap normal, fokuskan pemeriksaan pada aplikasi yang bermasalah.

Untuk WordPress, periksa error PHP, plugin atau tema yang baru diperbarui, serta perubahan konfigurasi cache. Jika error muncul setelah perubahan tertentu, pertimbangkan untuk mengembalikan perubahan tersebut secara terkontrol.

Untuk Laravel, periksa log aplikasi, koneksi database, permission direktori yang memang perlu ditulis aplikasi, serta konfigurasi environment. Jangan menggunakan chmod -R 777 untuk mengatasi masalah permission karena tindakan itu memperluas akses secara tidak aman.

Jika database tidak bisa diakses atau aplikasi mengalami exception, perbaiki masalah pada lapisan tersebut. Mengubah pengaturan OpenLiteSpeed tidak akan menyelesaikan exception aplikasi yang menjadi penyebab utama kegagalan permintaan.

5. Jika error muncul setelah upgrade atau perubahan modul

Jika website mulai menampilkan 503 tepat setelah pembaruan OpenLiteSpeed atau pemasangan modul, periksa error log dan kompatibilitas komponen terlebih dahulu.

Sebagai contoh, dokumentasi CyberPanel menyebut ketidakcocokan ABI ModSecurity sebagai salah satu kemungkinan penyebab 503 pada konfigurasi OpenLiteSpeed tertentu. Namun, hal tersebut hanya relevan jika modul tersebut memang digunakan dan log mendukung dugaan itu.

Jangan langsung menonaktifkan seluruh modul keamanan atau melakukan downgrade. Identifikasi komponen yang bermasalah, pastikan kompatibilitas versi, lalu ikuti prosedur perbaikan yang sesuai dengan instalasi kamu.

Verifikasi Setelah Perbaikan

Setelah menerapkan solusi, lakukan pengujian berikut untuk memastikan website merespons kembali.

1. Periksa status service dan log

sudo systemctl is-active lswssudo tail -n 50 /usr/local/lsws/logs/error.log

Perintah pertama memeriksa apakah service tercatat aktif. Perintah kedua menampilkan log terbaru untuk mencari error yang masih terjadi.

Status active saja tidak menjamin PHP dan seluruh website sudah berfungsi normal.

2. Uji respons HTTP

Untuk website HTTP:

curl -sS -o /dev/null -w '%{http_code}\n' \--max-time 15 http://example.com/

Untuk HTTPS:

curl -sS -o /dev/null -w '%{http_code}\n' \--max-time 15 https://example.com/

Ganti example.com dengan domain sebenarnya. Perintah ini hanya menampilkan kode HTTP dan membatasi waktu tunggu hingga 15 detik.

Respons 200 biasanya menunjukkan permintaan berhasil, sedangkan 301 atau 302 bisa menunjukkan redirect yang memang direncanakan. Jika masih mendapat 503, periksa log pada waktu pengujian. Kode 000 dari curl berarti tidak ada kode HTTP yang berhasil diterima, misalnya karena koneksi gagal atau timeout.

Jika website menggunakan virtual host dengan konfigurasi khusus, pengujian dari domain sebenarnya lebih representatif daripada sekadar mengakses 127.0.0.1.

3. Uji dari browser dan periksa halaman dinamis

Buka website dari browser, lalu uji halaman yang sebelumnya gagal. Jika halaman utama sudah berjalan, tetapi dashboard WordPress atau route Laravel masih menghasilkan error, lanjutkan pemeriksaan pada PHP dan aplikasi.

Hasil pengujian yang baik adalah website memberikan respons sesuai fungsi yang diharapkan, bukan hanya berhenti menampilkan halaman 503.

Pencegahan Error 503 pada CyberPanel

Untuk mengurangi risiko masalah yang sama terulang, terapkan beberapa kebiasaan berikut:

• Pantau log secara berkala. Periksa error log OpenLiteSpeed dan log aplikasi setelah perubahan konfigurasi atau pembaruan.

• Awasi penggunaan resource. Pantau RAM, CPU, kapasitas disk, dan pola trafik ketika website mulai lambat.

• Cadangkan konfigurasi. Simpan salinan konfigurasi sebelum mengubah PHP handler, external application, atau pengaturan virtual host.

• Uji perubahan secara bertahap. Jika error muncul setelah pembaruan plugin, tema, PHP, atau modul, catat perubahan terakhir agar penyebab lebih mudah ditemukan.

• Sesuaikan batas PHP dengan kapasitas server. Jumlah worker dan koneksi harus mempertimbangkan kebutuhan aplikasi serta memori yang tersedia.

• Hindari restart berulang tanpa diagnosis. Restart bisa menjadi tindakan pemulihan, tetapi tidak menggantikan pemeriksaan penyebab utama.

FAQ

1. Kenapa website CyberPanel tiba-tiba error 503?

Penyebabnya bisa berupa OpenLiteSpeed yang gagal memproses permintaan, PHP/LSAPI yang bermasalah, resource server yang tidak mencukupi, atau backend aplikasi yang tidak merespons. Periksa error log pada waktu kejadian untuk menentukan penyebab yang paling mungkin.

2. Apakah restart OpenLiteSpeed bisa mengatasi error 503?

Bisa jika masalahnya berkaitan dengan kondisi service yang dapat dipulihkan melalui restart. Namun, jika penyebabnya adalah konfigurasi PHP yang salah, resource yang habis, atau error aplikasi, masalah dapat muncul kembali setelah service dijalankan.

3. Di mana lokasi error log OpenLiteSpeed pada CyberPanel?

Lokasi log utama yang umum digunakan adalah:

/usr/local/lsws/logs/error.log

Kamu bisa membacanya dengan sudo tail -n 100 /usr/local/lsws/logs/error.log. Untuk masalah satu domain, periksa juga log virtual host dan log PHP jika tersedia.

4. Apakah error 503 selalu disebabkan oleh RAM VPS yang penuh?

Tidak. RAM yang tidak mencukupi adalah salah satu kemungkinan, tetapi 503 juga dapat muncul akibat kegagalan PHP, masalah konfigurasi handler, backend yang tidak merespons, atau ketidakcocokan modul. Periksa log sebelum menambah resource server.

5. Bagaimana jika panel CyberPanel bisa dibuka tetapi website tetap error 503?

Kondisi itu mengarahkan pemeriksaan ke layanan yang menangani website, seperti OpenLiteSpeed, PHP/LSAPI, virtual host, atau aplikasi. Periksa status lsws dan error log web server terlebih dahulu, lalu lanjutkan ke log PHP dan aplikasi jika diperlukan.

Penutup

Untuk mengatasi CyberPanel website error 503 Service Unavailable, mulailah dengan membedakan apakah masalah terjadi pada semua website atau hanya satu domain. Periksa status OpenLiteSpeed, baca log error, evaluasi proses PHP/LSAPI, dan ukur penggunaan resource sebelum menerapkan perubahan.

Jika website masih menampilkan 503, catat pesan error lengkap dan waktu kejadian. Informasi tersebut lebih berguna untuk menentukan solusi daripada menjalankan restart berulang atau mengubah konfigurasi tanpa mengetahui penyebabnya.