Installationsfehler

Der Installer stoppt beim ersten schwerwiegenden Problem und gibt eine rote Zeile aus, die mit ✗ beginnt. Beheben Sie die Ursache und führen Sie denselben Befehl erneut aus — der Installer kann sicher wiederholt werden. Informative Zeilen beginnen mit •, erfolgreiche Schritte mit ✓.

Systemprüfungen

Meldung	Ursache	Behebung
must be run as root (sudo)	Nicht als Root ausgeführt	Stellen Sie sudo vor den Befehl oder führen Sie ihn als Root aus.
only Ubuntu 22.04/24.04 is supported (this host: …)	Andere Distribution oder Version	Verwenden Sie einen Ubuntu 22.04 oder 24.04 Server.
only x86_64 is supported	ARM oder andere CPU	Verwenden Sie einen x86_64 Server.
requires ≥ 2 GB RAM (host has … MB)	Zu wenig Arbeitsspeicher	Fügen Sie RAM hinzu.
requires ≥ 8 GB free disk space on / (… GB available)	Root-Dateisystem fast voll	Geben Sie Speicher frei oder vergrößern Sie /.
missing --license / missing --domain	Erste Installation ohne diese Parameter	Übergeben Sie beide — siehe Installation.
unknown argument: …	Tippfehler in einem Parameter	Überprüfen Sie die Schreibweise; führen Sie es mit --help aus.
apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)	Die Paketverwaltung ist gesperrt	Warten Sie einige Minuten (ein frisch gebootetes Ubuntu führt automatische Updates durch) und starten Sie den Befehl erneut.
… is a symlink — aborting	/opt/nexcmp oder /etc/nexcmp ist ein symbolischer Link	Ersetzen Sie ihn durch ein echtes Verzeichnis — der Installer lehnt Symlinks aus Sicherheitsgründen ab.

Lizenzaktivierung

Meldung	Ursache	Behebung
cannot connect to https://nexcmp.com	Kein ausgehendes HTTPS zum Lizenzserver	Überprüfen Sie DNS, Firewall und Proxy auf dem Server: curl -I https://nexcmp.com.
license activation failed (HTTP …): <message>	Der Lizenzserver hat den Schlüssel abgelehnt	Lesen Sie die Meldung: falscher Schlüssel, Domain stimmt nicht mit der Lizenz überein, Lizenz gesperrt oder widerrufen. Prüfen Sie die Lizenzseite unter nexcmp.com/licenses.
no release available for this license yet	Die Lizenz hat kein herunterladbares Release	Wenden Sie sich an den Vertrieb; siehe Support.

Download und Verifizierung

Meldung	Ursache	Behebung
failed to download release X	Netzwerkproblem während des Downloads	Erneut ausführen.
sha256 mismatch (… ≠ …)	Die Datei kam beschädigt an oder wurde verändert	Erneut ausführen; tritt das Problem wieder auf, modifiziert möglicherweise ein Proxy die Downloads — versuchen Sie es von einem anderen Netzwerk aus.
release X is unsigned — refusing to install	Der Server hat keine Signatur geliefert	Niemals umgehen; wenden Sie sich an den Support.
INVALID SIGNATURE for version X — aborting	Die Ed25519-Signatur konnte nicht verifiziert werden	Installieren Sie das Paket nicht. Wenden Sie sich an den Support — dies bedeutet, dass die Datei kein offizielles Release ist.
openssl failed to read public key	Sehr altes oder beschädigtes OpenSSL	Aktualisieren Sie das Paket openssl.
invalid version: …	Unerwartete Daten vom Server	Erneut ausführen; wenden Sie sich an den Support, falls das Problem weiterhin besteht.

Dienststart

Meldung	Ursache	Behebung
service failed to start — check: journalctl -u nexcmp -n 50	Das Panel hat nicht innerhalb von 3 Minuten auf /healthz geantwortet	Lesen Sie das Journal. Häufige Ursachen: Der Port (Standard 3000) wird bereits verwendet (`ss -ltnp

nginx und TLS

Meldung	Ursache	Behebung
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS	Der A/AAAA-Eintrag fehlt oder ist fehlerhaft	Siehe DNS und Cloudflare, führen Sie den Befehl dann erneut aus.
certbot could not get a certificate yet — re-run the installer once DNS has settled	Let's Encrypt-Validierung fehlgeschlagen (Port 80 blockiert, DNS nicht propagiert, Rate-Limit)	Öffnen Sie Port 80, warten Sie auf DNS, führen Sie den Befehl erneut aus. Prüfen Sie /var/log/letsencrypt/letsencrypt.log.
certbot could not renew now — keeping the existing certificate	Vorübergehender Fehler bei der Verlängerung	Unbedenklich; später erneut versuchen.
nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)	Eine andere nginx-Site kollidiert (gleicher server_name, doppelte Einstellungen)	Führen Sie sudo nginx -t aus, beheben Sie den Konflikt und starten Sie den Prozess erneut.
apt-get could not install nginx / certbot oder E: Failed to fetch … 404 Not Found	Paketverwaltung gesperrt oder der Paketindex des Servers ist veraltet (typisch bei einem Template-Image, das längere Zeit nicht aktualisiert wurde)	Führen Sie sudo apt-get update aus, warten Sie, bis ein anderer apt-Prozess abgeschlossen ist, und starten Sie den Installer dann erneut.
openssl could not create the self-signed certificate	OpenSSL-Problem	Aktualisieren Sie openssl; erneut ausführen.

Nach der Installation

Symptom	Ursache	Behebung
Browser kann https://<domain> nicht öffnen	DNS oder TLS nicht bereit	sudo nexcmp status; nutzen Sie den Notzugriff.
ERR_TOO_MANY_REDIRECTS	Cloudflare-SSL-Modus Flexible	Setzen Sie Full (strict) — details.
Assistent meldet, dass der Einrichtungs-Code falsch ist	Tippfehler oder ein Code von einer früheren Installation	Führen Sie sudo nexcmp status aus und kopieren Sie den aktuellen Code.
Lizenz zeigt HTTP 421	Dateien in /var/lib/nexcmp gehören root	sudo nexcmp fix-owner, danach sudo systemctl restart nexcmp.