--- title: Installationsfehler description: Jede Fehlermeldung des NexCMP-Installers, ihre Ursache und Behebung — Anforderungen, Lizenzaktivierung, Download-Überprüfung, Dienste und Nginx/TLS. url: https://nexcmp.com/de/docs/troubleshooting/installation-errors/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Installationsfehler {#installation-errors} 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 {#machine-checks} | 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](https://nexcmp.com/de/docs/getting-started/installation/#parameters). | | `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 {#license-activation} | 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 …): ` | 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](https://nexcmp.com/licenses). | | `no release available for this license yet` | Die Lizenz hat kein herunterladbares Release | Wenden Sie sich an den Vertrieb; siehe [Support](https://nexcmp.com/de/docs/troubleshooting/support/). | ## Download und Verifizierung {#download-and-verification} | 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 {#service-start} | 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 | grep 3000`) — installieren Sie ihn mit `--port` neu; Dateien gehören root in `/var/lib/nexcmp` — führen Sie `sudo nexcmp fix-owner` aus. | ## nginx und TLS {#nginx-and-tls} | Meldung | Ursache | Behebung | |---|---|---| | `DNS does not point to (nor to Cloudflare) — skipping nginx/TLS` | Der A/AAAA-Eintrag fehlt oder ist fehlerhaft | Siehe [DNS und Cloudflare](https://nexcmp.com/de/docs/getting-started/dns-and-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 {#after-installation} | Symptom | Ursache | Behebung | |---|---|---| | Browser kann `https://` nicht öffnen | DNS oder TLS nicht bereit | `sudo nexcmp status`; nutzen Sie den [Notzugriff](https://nexcmp.com/de/docs/getting-started/cli-reference/#emergency-access). | | `ERR_TOO_MANY_REDIRECTS` | Cloudflare-SSL-Modus **Flexible** | Setzen Sie **Full (strict)** — [details](https://nexcmp.com/de/docs/getting-started/dns-and-cloudflare/). | | 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`. |