Galat instalasi
Penginstal berhenti pada masalah fatal pertama dan mencetak baris merah yang diawali dengan ✗. Perbaiki penyebabnya dan jalankan perintah yang sama lagi — penginstal aman untuk diulang. Baris informatif diawali dengan •, langkah yang berhasil dengan ✓.
Pemeriksaan mesin
| Pesan | Penyebab | Solusi |
|---|---|---|
must be run as root (sudo) | Tidak berjalan sebagai root | Awali perintah dengan sudo, atau jalankan sebagai root. |
only Ubuntu 22.04/24.04 is supported (this host: …) | Distribusi atau versi lain | Gunakan server Ubuntu 22.04 atau 24.04. |
only x86_64 is supported | ARM atau CPU lain | Gunakan server x86_64. |
requires ≥ 2 GB RAM (host has … MB) | Memori terlalu sedikit | Tambahkan RAM. |
requires ≥ 8 GB free disk space on / (… GB available) | Sistem file root hampir penuh | Kosongkan ruang atau perbesar /. |
missing --license / missing --domain | Instalasi pertama tanpa parameter tersebut | Lewatkan keduanya — lihat Installation. |
unknown argument: … | Kesalahan ketik pada parameter | Periksa ejaan; jalankan dengan --help. |
apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running) | Pengelola paket terkunci | Tunggu beberapa menit (Ubuntu baru menjalankan pembaruan otomatis setelah boot) lalu jalankan ulang. |
… is a symlink — aborting | /opt/nexcmp atau /etc/nexcmp adalah symbolic link | Ganti dengan direktori asli — penginstal menolak symlink demi keamanan. |
Aktivasi lisensi
| Pesan | Penyebab | Solusi |
|---|---|---|
cannot connect to https://nexcmp.com | Tidak ada HTTPS keluar ke server lisensi | Periksa DNS, firewall, dan proxy pada server: curl -I https://nexcmp.com. |
license activation failed (HTTP …): <message> | Server lisensi menolak kunci tersebut | Baca pesan: kunci salah, domain tidak cocok dengan lisensi, lisensi ditangguhkan atau dicabut. Periksa halaman lisensi di nexcmp.com/licenses. |
no release available for this license yet | Lisensi tidak memiliki rilis yang dapat diunduh | Hubungi bagian penjualan; lihat Support. |
Unduhan dan verifikasi
| Pesan | Penyebab | Solusi |
|---|---|---|
failed to download release X | Masalah jaringan selama pengunduhan | Jalankan ulang. |
sha256 mismatch (… ≠ …) | File tiba dalam keadaan rusak atau telah diubah | Jalankan ulang; jika terulang kembali, proxy mungkin mengubah unduhan — coba dari jaringan lain. |
release X is unsigned — refusing to install | Server tidak memberikan tanda tangan | Jangan pernah melewati; hubungi dukungan. |
INVALID SIGNATURE for version X — aborting | Tanda tangan Ed25519 tidak dapat diverifikasi | Jangan menginstal. Hubungi dukungan — ini berarti file tersebut bukan rilis resmi. |
openssl failed to read public key | OpenSSL sangat lama atau rusak | Perbarui paket openssl. |
invalid version: … | Data tidak terduga dari server | Jalankan ulang; hubungi dukungan jika masalah berlanjut. |
Memulai layanan
| Pesan | Penyebab | Solusi |
|---|---|---|
service failed to start — check: journalctl -u nexcmp -n 50 | Panel tidak merespons /healthz dalam waktu 3 menit | Baca jurnal. Penyebab umum: port (default 3000) sudah digunakan (`ss -ltnp |
nginx dan TLS
| Pesan | Penyebab | Solusi |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | Record A/AAAA hilang atau salah | Lihat DNS and Cloudflare, lalu jalankan ulang. |
certbot could not get a certificate yet — re-run the installer once DNS has settled | Validasi Let's Encrypt gagal (port 80 diblokir, DNS belum merambat, batasan tingkat/rate limit) | Buka port 80, tunggu DNS, jalankan ulang. Periksa /var/log/letsencrypt/letsencrypt.log. |
certbot could not renew now — keeping the existing certificate | Kegagalan pembaruan sementara | Tidak berbahaya; jalankan ulang nanti. |
nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t) | Situs nginx lain mengalami konflik (server_name sama, pengaturan duplikat) | Jalankan sudo nginx -t dan perbaiki konflik tersebut, lalu jalankan ulang. |
apt-get could not install nginx / certbot, atau E: Failed to fetch … 404 Not Found | Pengelola paket terkunci, atau indeks paket server sudah kedaluwarsa (umum pada gambar templat yang sudah lama tidak diperbarui) | Jalankan sudo apt-get update, tunggu proses apt lainnya selesai, lalu jalankan ulang penginstal. |
openssl could not create the self-signed certificate | Masalah OpenSSL | Perbarui openssl; jalankan ulang. |
Setelah instalasi
| Gejala | Penyebab | Solusi |
|---|---|---|
Peramban tidak dapat membuka https://<domain> | DNS atau TLS belum siap | sudo nexcmp status; gunakan emergency access. |
ERR_TOO_MANY_REDIRECTS | Mode SSL Cloudflare Flexible | Atur Full (strict) — detail. |
| Wizard mengatakan "setup code" salah | Kesalahan ketik atau kode dari instalasi sebelumnya | Jalankan sudo nexcmp status dan salin kode saat ini. |
| Lisensi menampilkan HTTP 421 | File dalam /var/lib/nexcmp dimiliki oleh root | sudo nexcmp fix-owner, lalu sudo systemctl restart nexcmp. |