Diagnostic Playbooks
Troubleshooting Common VPS Issues
Actionable solutions for Git clone timeouts, 502 Bad Gateway, Out of Memory crashes, and port conflicts.
1. Git Clone Timeout (Failed to connect to github.com port 443)
Network / IPv6Penyebab: Sebagian besar provider VPS di Indonesia mengalami kendala routing IPv6 ke GitHub. Linux mencoba terhubung ke alamat IPv6 GitHub terlebih dahulu, mengalami blackhole, dan menggantung selama ~130 detik sebelum timeout.
Solusi & Penanganan:
Nonaktifkan IPv6 di server VPS Anda agar koneksi otomatis menggunakan IPv4 murni:
sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1
sudo sysctl -w net.ipv6.conf.default.disable_ipv6=1
sudo sysctl -w net.ipv6.conf.default.disable_ipv6=1
Tes koneksi dengan: curl -I https://github.com.
2. Error 502 Bad Gateway di Traefik
Routing / PortPenyebab: Traefik berhasil mengarahkan domain ke container, tetapi container aplikasi Anda menolak koneksi atau belum siap menerima request (Health check gagal atau Target Port salah).
Solusi & Penanganan:
- Cek Target Port: Buka Project Settings. Pastikan Target Port cocok dengan port aplikasi Anda (misal: Next.js = 3000, Laravel = 8000/80).
- Periksa Container Runtime Logs: Buka tab Logs di dashboard untuk memeriksa apakah aplikasi mengalami runtime crash atau exception saat booting.
- Tunggu beberapa detik: Beberapa framework seperti Next.js SSR membutuhkan 3–5 detik untuk compile halaman pertama kali.
3. Build Gagal / Macet Karena Out of Memory (OOM Killer)
VPS RAM / SwapPenyebab: Framework modern seperti Next.js atau Vite membutuhkan RAM minimal 2GB–3GB saat proses kompilasi `npm run build`. Pada VPS dengan RAM 1GB–2GB, kernel Linux akan mematikan proses build (OOM Killed).
Solusi & Penanganan:
Tambahkan 2GB Swap Memory di server VPS Anda agar build berjalan lancar:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
4. Port 80 atau 443 Sudah Dipakai Layanan Lain (Port Conflict)
Port ConflictPenyebab: Jika VPS sebelumnya pernah dipasangi Nginx, Apache, atau Caddy bawaan OS, Traefik tidak bisa mengikat port 80 dan 443 sehingga reverse proxy gagal berjalan.
Solusi & Penanganan:
Matikan dan nonaktifkan web server bawaan di VPS:
sudo systemctl stop nginx apache2 2>/dev/null
sudo systemctl disable nginx apache2 2>/dev/null
sudo systemctl disable nginx apache2 2>/dev/null
Lalu restart sPanel: sudo systemctl restart spanel.
Masih belum menemukan jawaban?
Kunjungi issue tracker di GitHub atau buka diskusi untuk berdiskusi dengan komunitas.