---
title: Ошибки установки
description: Все ошибки установщика NexCMP, их причины и решения: системные требования, лицензия, проверка загрузок, сервисы и nginx/TLS.
url: https://nexcmp.com/ru/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Ошибки установки {#installation-errors}

Установщик останавливается при первой неустранимой проблеме и выводит красную строку с `✗`. Устраните причину и **повторите команду** — повторный запуск установщика безопасен. Информационные сообщения начинаются с `•`, успешно выполненные шаги — с `✓`.

## Проверки сервера {#machine-checks}

| Сообщение | Причина | Решение |
|---|---|---|
| `must be run as root (sudo)` | Запуск не от имени root | Добавьте в начале команды `sudo` или выполните ее от root. |
| `only Ubuntu 22.04/24.04 is supported (this host: …)` | Другой дистрибутив или версия | Используйте сервер с Ubuntu 22.04 или 24.04. |
| `only x86_64 is supported` | ARM или другая архитектура процессора | Используйте сервер на базе x86_64. |
| `requires ≥ 2 GB RAM (host has … MB)` | Недостаточно оперативной памяти | Добавьте RAM. |
| `requires ≥ 8 GB free disk space on / (… GB available)` | Корневая файловая система почти заполнена | Освободите место или увеличьте `/`. |
| `missing --license` / `missing --domain` | Первая установка без обязательных параметров | Укажите оба параметра — см. [Установка](https://nexcmp.com/ru/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` является символической ссылкой | Замените ее реальным каталогом — установщик отклоняет символические ссылки в целях безопасности. |

## Активация лицензии {#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` | Для этой лицензии нет доступного для скачивания релиза | Свяжитесь с отделом продаж; см. [Поддержка](https://nexcmp.com/ru/docs/troubleshooting/support/). |

## Скачивание и проверка {#download-and-verification}

| Сообщение | Причина | Решение |
|---|---|---|
| `failed to download release X` | Сетевая ошибка при скачивании | Запустите снова. |
| `sha256 mismatch (… ≠ …)` | Файл поврежден при передаче или был изменен | Запустите снова; если ошибка повторяется, возможно, прокси изменяет загружаемые файлы — попробуйте из другой сети. |
| `release X is unsigned — refusing to install` | Сервер не предоставил подпись | Ни в коем случае не обходите проверку; обратитесь в службу поддержки. |
| `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` | Панель не ответила на `/healthz` в течение 3 минут | Проверьте журнал. Распространенные причины: порт (по умолчанию 3000) уже занят (`ss -ltnp | grep 3000`) — выполните переустановку с `--port`; файлы принадлежат root в `/var/lib/nexcmp` — выполните `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 и Cloudflare](https://nexcmp.com/ru/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`; используйте [аварийный доступ](https://nexcmp.com/ru/docs/getting-started/cli-reference/#emergency-access). |
| `ERR_TOO_MANY_REDIRECTS` | Режим Cloudflare SSL **Flexible** | Установите **Full (strict)** — [подробнее](https://nexcmp.com/ru/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`. |