---
title: Galat instalasi
description: Semua pesan error penginstal NexCMP, penyebab, dan cara mengatasinya — persyaratan, aktivasi lisensi, verifikasi unduhan, layanan, serta nginx/TLS.
url: https://nexcmp.com/id/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Galat instalasi {#installation-errors}

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 {#machine-checks}

| 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](https://nexcmp.com/id/docs/getting-started/installation/#parameters). |
| `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 {#license-activation}

| 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](https://nexcmp.com/licenses). |
| `no release available for this license yet` | Lisensi tidak memiliki rilis yang dapat diunduh | Hubungi bagian penjualan; lihat [Support](https://nexcmp.com/id/docs/troubleshooting/support/). |

## Unduhan dan verifikasi {#download-and-verification}

| 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 {#service-start}

| 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 | grep 3000`) — instal ulang dengan `--port`; file dimiliki oleh root di `/var/lib/nexcmp` — jalankan `sudo nexcmp fix-owner`. |

## nginx dan TLS {#nginx-and-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](https://nexcmp.com/id/docs/getting-started/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 {#after-installation}

| Gejala | Penyebab | Solusi |
|---|---|---|
| Peramban tidak dapat membuka `https://<domain>` | DNS atau TLS belum siap | `sudo nexcmp status`; gunakan [emergency access](https://nexcmp.com/id/docs/getting-started/cli-reference/#emergency-access). |
| `ERR_TOO_MANY_REDIRECTS` | Mode SSL Cloudflare **Flexible** | Atur **Full (strict)** — [detail](https://nexcmp.com/id/docs/getting-started/dns-and-cloudflare/). |
| 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`. |