---
title: इंस्टॉलेशन त्रुटियां
description: NexCMP इंस्टॉलर द्वारा प्रिंट की जाने वाली प्रत्येक त्रुटि संदेश, इसके कारण और इसे ठीक करने का तरीका — आवश्यकताएं, लाइसेंस सक्रियण, डाउनलोड सत्यापन, सेवाएं और nginx/TLS।
url: https://nexcmp.com/hi/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# इंस्टॉलेशन त्रुटियां {#installation-errors}

इंस्टॉलर पहली गंभीर समस्या पर रुक जाता है और `✗` से शुरू होने वाली एक लाल लाइन प्रिंट करता है। कारण को ठीक करें और **वही कमांड दोबारा चलाएं** — इंस्टॉलर को दोहराना सुरक्षित है। सूचनात्मक लाइनें `•` से शुरू होती हैं, सफल चरण `✓` से।

## मशीन जाँच {#machine-checks}

| संदेश | कारण | सुधार |
|---|---|---|
| `must be run as root (sudo)` | रूट के रूप में नहीं चल रहा है | कमांड से पहले `sudo` जोड़ें, या रूट के रूप में चलाएं। |
| `only Ubuntu 22.04/24.04 is supported (this host: …)` | कोई अन्य वितरण या संस्करण | Ubuntu 22.04 या 24.04 सर्वर का उपयोग करें। |
| `only x86_64 is supported` | ARM या अन्य CPU | x86_64 सर्वर का उपयोग करें। |
| `requires ≥ 2 GB RAM (host has … MB)` | बहुत कम मेमोरी | RAM जोड़ें। |
| `requires ≥ 8 GB free disk space on / (… GB available)` | रूट फ़ाइल सिस्टम लगभग भरा हुआ है | जगह खाली करें या `/` को बड़ा करें। |
| `missing --license` / `missing --domain` | उन पैरामीटर के बिना पहली बार इंस्टॉल करना | दोनों पास करें — [Installation](https://nexcmp.com/hi/docs/getting-started/installation/#parameters) देखें। |
| `unknown argument: …` | पैरामीटर में टाइपो | वर्तनी जांचें; `--help` के साथ चलाएं। |
| `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | पैकेज मैनेजर लॉक है | कुछ मिनट प्रतीक्षा करें (नया Ubuntu बूट होने के बाद स्वचालित अपडेट चलाता है) और दोबारा चलाएं। |
| `… is a symlink — aborting` | `/opt/nexcmp` या `/etc/nexcmp` एक प्रतीकात्मक लिंक (symbolic link) है | इसे एक वास्तविक निर्देशिका से बदलें — सुरक्षा कारणों से इंस्टॉलर symlinks को अस्वीकार करता है। |

## लाइसेंस सक्रियण {#license-activation}

| संदेश | कारण | सुधार |
|---|---|---|
| `cannot connect to https://nexcmp.com` | लाइसेंस सर्वर के लिए कोई आउटबाउंड HTTPS नहीं है | सर्वर पर DNS, फ़ायरवॉल और प्रॉक्सी की जाँच करें: `curl -I https://nexcmp.com`। |
| `license activation failed (HTTP …): <message>` | लाइसेंस सर्वर ने कुंजी को अस्वीकार कर दिया | संदेश पढ़ें: गलत कुंजी, डोमेन लाइसेंस से मेल नहीं खाता, लाइसेंस निलंबित या रद्द कर दिया गया है। [nexcmp.com/licenses](https://nexcmp.com/licenses) पर लाइसेंस पेज देखें। |
| `no release available for this license yet` | लाइसेंस के लिए कोई डाउनलोड करने योग्य रिलीज़ उपलब्ध नहीं है | सेल्स से संपर्क करें; [Support](https://nexcmp.com/hi/docs/troubleshooting/support/) देखें। |

## डाउनलोड और सत्यापन {#download-and-verification}

| संदेश | कारण | सुधार |
|---|---|---|
| `failed to download release X` | डाउनलोड के दौरान नेटवर्क समस्या | दोबारा चलाएं। |
| `sha256 mismatch (… ≠ …)` | फ़ाइल क्षतिग्रस्त स्थिति में पहुँची या उसमें बदलाव किया गया था | दोबारा चलाएं; यदि यह दोबारा हो, तो कोई प्रॉक्सी डाउनलोड में बदलाव कर रही होगी — किसी अन्य नेटवर्क से प्रयास करें। |
| `release X is unsigned — refusing to install` | सर्वर ने कोई हस्ताक्षर (signature) नहीं दिया | कभी भी बाईपास न करें; सहायता (support) से संपर्क करें। |
| `INVALID SIGNATURE for version X — aborting` | Ed25519 हस्ताक्षर सत्यापित नहीं होता है | इंस्टॉल **न** करें। सहायता से संपर्क करें — इसका अर्थ है कि फ़ाइल आधिकारिक रिलीज़ नहीं है। |
| `openssl failed to read public key` | बहुत पुराना या खराब OpenSSL | `openssl` पैकेज को अपडेट करें। |
| `invalid version: …` | सर्वर से अप्रत्याशित डेटा प्राप्त हुआ | दोबारा चलाएं; यदि समस्या बनी रहे तो सहायता से संपर्क करें। |

## सेवा प्रारंभ {#service-start}

| संदेश | कारण | सुधार |
|---|---|---|
| `service failed to start — check: journalctl -u nexcmp -n 50` | पैनल ने 3 मिनट के भीतर `/healthz` का उत्तर नहीं दिया | जर्नल पढ़ें। सामान्य कारण: पोर्ट (डिफ़ॉल्ट 3000) पहले से उपयोग में है (`ss -ltnp | grep 3000`) — `--port` के साथ पुनः इंस्टॉल करें; `/var/lib/nexcmp` में फ़ाइलें root के स्वामित्व में हैं — `sudo nexcmp fix-owner` चलाएं। |

## nginx और TLS {#nginx-and-tls}

| संदेश | कारण | सुधार |
|---|---|---|
| `DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS` | A/AAAA रिकॉर्ड गायब है या गलत है | [DNS and Cloudflare](https://nexcmp.com/hi/docs/getting-started/dns-and-cloudflare/) देखें, फिर दोबारा चलाएं। |
| `certbot could not get a certificate yet — re-run the installer once DNS has settled` | Let's Encrypt सत्यापन विफल रहा (पोर्ट 80 अवरुद्ध है, DNS प्रचारित नहीं हुआ है, दर सीमा) | पोर्ट 80 खोलें, DNS की प्रतीक्षा करें, दोबारा चलाएं। `/var/log/letsencrypt/letsencrypt.log` की जाँच करें। |
| `certbot could not renew now — keeping the existing certificate` | अस्थायी नवीनीकरण विफलता | हानिरहित; बाद में पुनः चलाएं। |
| `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | एक अन्य nginx साइट संघर्ष करती है (समान `server_name`, डुप्लिकेट सेटिंग्स) | `sudo nginx -t` चलाएं और संघर्ष को ठीक करें, फिर दोबारा चलाएं। |
| `apt-get could not install nginx` / `certbot`, या `E: Failed to fetch … 404 Not Found` | पैकेज मैनेजर लॉक है, या सर्वर का पैकेज इंडेक्स पुराना है (ऐसी टेम्पलेट इमेज पर आम है जिसे कुछ समय से अपडेट नहीं किया गया है) | `sudo apt-get update` चलाएं, किसी अन्य apt प्रक्रिया के समाप्त होने की प्रतीक्षा करें, फिर इंस्टॉलर को दोबारा चलाएं। |
| `openssl could not create the self-signed certificate` | OpenSSL समस्या | `openssl` अपडेट करें; दोबारा चलाएं। |

## इंस्टॉलेशन के बाद {#after-installation}

| लक्षण | कारण | सुधार |
|---|---|---|
| ब्राउज़र `https://<domain>` नहीं खोल सकता | DNS या TLS तैयार नहीं है | `sudo nexcmp status`; [emergency access](https://nexcmp.com/hi/docs/getting-started/cli-reference/#emergency-access) का उपयोग करें। |
| `ERR_TOO_MANY_REDIRECTS` | Cloudflare SSL मोड **Flexible** | **Full (strict)** सेट करें — [details](https://nexcmp.com/hi/docs/getting-started/dns-and-cloudflare/)। |
| विज़ार्ड कहता है कि "setup code" गलत है | टाइपोग्राफिकल त्रुटि या किसी पुराने इंस्टॉलेशन का कोड | `sudo nexcmp status` चलाएँ और वर्तमान कोड कॉपी करें। |
| लाइसेंस HTTP 421 दिखाता है | `/var/lib/nexcmp` में मौजूद फ़ाइलें root के स्वामित्व में हैं | `sudo nexcmp fix-owner`, फिर `sudo systemctl restart nexcmp`। |