10 Nov 2026 · 5 min read · ID

Cara Menghapus .maintenance: Keluar dari WordPress Stuck in Maintenance Mode di cPanel

Panduan praktis menghapus file .maintenance untuk keluar dari maintenance mode di hosting cPanel, plus verifikasi update, backup singkat, dan tips pencegahan.

By Tim Gocelerus

Cara Menghapus .maintenance: Keluar dari WordPress Stuck in Maintenance Mode di cPanel

Masalah singkat: situs menampilkan pesan "Briefly unavailable for scheduled maintenance. Check back in a minute." dan tidak kembali normal karena WordPress meninggalkan file .maintenance setelah update terhenti. Berikut cara aman menghapusnya lewat beberapa metode, bagaimana memeriksa apakah update terpotong, dan apa yang harus dicegah selanjutnya.

Apa itu file .maintenance

Saat WordPress melakukan update otomatis atau beberapa update sekaligus, ia membuat file bernama .maintenance di root instalasi (folder yang sama dengan wp-config.php, wp-admin, wp-content). Selama file ini ada, pengunjung melihat pesan maintenance. Jika proses update terhenti, file ini bisa tertinggal dan membuat situs "stuck".

Lokasi yang biasa digunakan contoh:

/home/username/public_html
/home/username/domains/example.com/public_html
/var/www/example.com/public_html

Pastikan Anda bekerja di root WordPress yang benar — folder yang sama dengan wp-config.php.

Sebelum mulai: cek dan backup cepat

Sebelum mengubah file di server, lakukan langkah singkat ini:

  1. Pastikan Anda benar-benar berada di root instalasi WordPress (ada wp-config.php, wp-admin, wp-content).
  2. Ambil backup cepat file dan database jika update mungkin setengah-terpasang. Contoh perintah (di server dengan akses shell):
tar -czf /root/site-files-YYYY-MM-DD.tar.gz .
mysqldump -u dbuser -p dbname > /root/site-db-YYYY-MM-DD.sql
  1. Jangan langsung menghapus: praktik aman adalah me-rename file .maintenance dulu sehingga bisa dikembalikan jika perlu.

1) Lewat cPanel File Manager (GUI)

  1. Login ke cPanel, buka File Manager.
  2. Klik Settings (pojok kanan atas) dan centang "Show Hidden Files (dotfiles)".
  3. Buka folder instalasi WordPress (mis. public_html).
  4. Cari file bernama .maintenance.
  5. Praktik aman: klik kanan → Rename, ubah jadi mis. .maintenance.bak-20231010. Jika rename tidak memulihkan situs, kembali ke langkah selanjutnya.
  6. Jika ingin menghapus setelah memastikan update tidak berjalan, klik kanan → Delete.
  7. Refresh situs atau buka di jendela incognito untuk memastikan pesan hilang.

Catatan: jika Anda tidak melihat .maintenance, pastikan sudah berada di folder root WordPress yang benar.

2) Lewat FTP/SFTP

  1. Sambungkan dengan FTP/SFTP ke akun hosting Anda (gunakan credential yang benar).
  2. Tampilkan file tersembunyi di klien Anda (biasanya ada pengaturan "show hidden files").
  3. Masuk ke root WordPress (tempat wp-config.php berada) dan cari .maintenance.
  4. Ubah nama file menjadi .maintenance.bak- atau hapus bila yakin update tidak berjalan.

Contoh nama aman:

.maintenance.bak-20231010
  1. Coba buka situs di mode incognito.

3) Lewat SSH (power users)

SSH lebih cepat bila tersedia. Langkah umum:

  1. SSH ke server lalu pindah ke folder root WordPress:
cd /home/username/public_html
  1. Cek keberadaan file:
ls -la .maintenance
  1. Rename (disarankan) atau hapus:
mv .maintenance .maintenance.bak-$(date +%s)
# atau jika yakin:
rm .maintenance
  1. Refresh situs/web browser di mode incognito.

Peringatan: jangan hapus file kalau Anda yakin update masih berjalan — gunakan rename untuk bisa mengembalikan.

4) WP‑CLI (jika tersedia di server)

WP‑CLI menyediakan cara lewat WordPress API untuk mematikan maintenance mode:

wp maintenance-mode status
wp maintenance-mode deactivate

Jika perintah mengembalikan error atau WP‑CLI tidak tersedia, fallback ke penghapusan/rename file .maintenance seperti langkah di atas.

Periksa apakah update terpotong

Setelah .maintenance hilang, langkah berikut penting untuk memastikan tidak ada update setengah-terpasang:

  1. Periksa folder kerja update:
ls -la wp-content/upgrade

Jika ada sisa folder atau file dari proses update yang gagal, dan Anda yakin tidak ada proses update berjalan, Anda bisa hapus kontennya:

rm -rf wp-content/upgrade/*
  1. Masuk ke Dashboard → Updates untuk melihat apakah ada plugin, tema, atau core yang perlu diupdate ulang atau direinstall.
  2. Jika plugin/tema tampak rusak setelah penghapusan .maintenance, pertimbangkan untuk reinstall plugin/tema melalui Dashboard atau restore dari backup yang diambil sebelum update.

Catatan: jika Anda tidak yakin apakah update masih berlangsung, jangan hapus folder upgrade. Ambil backup dan selidiki dulu.

Verifikasi setelah tindakan

  1. Buka situs di mode incognito dan cek halaman depan.
  2. Login ke wp-admin untuk memastikan area admin dapat diakses.
  3. Cek Dashboard → Updates untuk status update.
  4. Jika Anda menggunakan caching (plugin atau server-side), kosongkan cache setelah perubahan.

Pencegahan agar tidak terjadi lagi

  • Lakukan update di waktu rendah trafik dan satu per satu bila memungkinkan.
  • Jangan menutup browser atau memutus koneksi saat melakukan update manual jika Anda melakukannya dari Dashboard.
  • Gunakan backup rutin sebelum melakukan update besar.
  • Jika hosting Anda menyediakan staging environment, uji update di staging dulu.

Caveat dan kapan minta bantuan

  • Menghapus .maintenance hanya menghilangkan tanda maintenance; bila update terpotong dan file yang diupdate (plugin/tema/core) setengah-terpasang, Anda mungkin perlu reinstall atau restore dari backup.
  • Jika Anda merasa ragu melakukan langkah di server (SSH/FTP) sendiri, minta bantuan teknis yang memahami struktur WordPress.

Penutup singkat

Gocelerus is cPanel web hosting for Southeast Asia, serving Indonesia and Cambodia first. Servers are in Singapore, with NVMe storage, LiteSpeed web server and Imunify360 security. Daily backups are included. Moving an existing website to Gocelerus is free (the team does the migration). Plans and prices are at https://gocelerus.com/pricing.

Sumber

Manage your cPanel servers from one dashboard

Connect your WHM to Gocelerus and manage PHP, SSL, and WordPress across all your cPanel accounts from one place.