---
title: Errores de instalación
description: Cada error del instalador de NexCMP, su causa y solución — requisitos, activación de licencia, verificación de descarga, servicios y nginx/TLS.
url: https://nexcmp.com/es/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Errores de instalación {#installation-errors}

El instalador se detiene ante el primer problema fatal y muestra una línea roja que empieza por `✗`. Corrija la causa y **vuelva a ejecutar el mismo comando**; el instalador se puede repetir sin peligro. Las líneas informativas empiezan por `•` y los pasos correctos, por `✓`.

## Comprobaciones de la máquina {#machine-checks}

| Mensaje | Causa | Solución |
|---|---|---|
| `must be run as root (sudo)` | No se ejecuta como root | Anteponga `sudo` al comando o ejecútelo como root. |
| `only Ubuntu 22.04/24.04 is supported (this host: …)` | Otra distribución o versión | Utilice un servidor Ubuntu 22.04 o 24.04. |
| `only x86_64 is supported` | ARM u otra CPU | Utilice un servidor x86_64. |
| `requires ≥ 2 GB RAM (host has … MB)` | Memoria insuficiente | Añada RAM. |
| `requires ≥ 8 GB free disk space on / (… GB available)` | Sistema de archivos raíz casi lleno | Libere espacio o amplíe `/`. |
| `missing --license` / `missing --domain` | Primera instalación sin esos parámetros | Indique ambos; consulte [Instalación](https://nexcmp.com/es/docs/getting-started/installation/#parameters). |
| `unknown argument: …` | Error tipográfico en un parámetro | Revise que esté bien escrito; ejecute con `--help`. |
| `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | El gestor de paquetes está bloqueado | Espere unos minutos (una instalación nueva de Ubuntu ejecuta actualizaciones automáticas tras el arranque) y vuelva a ejecutarlo. |
| `… is a symlink — aborting` | `/opt/nexcmp` o `/etc/nexcmp` es un enlace simbólico | Reemplácelo por un directorio real — el instalador rechaza los enlaces simbólicos por seguridad. |

## Activación de la licencia {#license-activation}

| Mensaje | Causa | Solución |
|---|---|---|
| `cannot connect to https://nexcmp.com` | Sin conexión HTTPS saliente hacia el servidor de licencias | Compruebe el DNS, el firewall y el proxy en el servidor: `curl -I https://nexcmp.com`. |
| `license activation failed (HTTP …): <message>` | El servidor de licencias rechazó la clave | Revise el mensaje: clave incorrecta, el dominio no coincide con la licencia o la licencia está suspendida o revocada. Compruebe la página de licencias en [nexcmp.com/licenses](https://nexcmp.com/licenses). |
| `no release available for this license yet` | La licencia no tiene una versión descargable | Póngase en contacto con ventas; consulte [Soporte](https://nexcmp.com/es/docs/troubleshooting/support/). |

## Descarga y verificación {#download-and-verification}

| Mensaje | Causa | Solución |
|---|---|---|
| `failed to download release X` | Problema de red durante la descarga | Vuelva a ejecutarlo. |
| `sha256 mismatch (… ≠ …)` | El archivo llegó dañado o fue modificado | Vuelva a ejecutarlo; si se repite, es posible que un proxy esté reescribiendo las descargas — pruebe desde otra red. |
| `release X is unsigned — refusing to install` | El servidor no proporcionó ninguna firma | Nunca lo omita; póngase en contacto con soporte técnico. |
| `INVALID SIGNATURE for version X — aborting` | La firma Ed25519 no se verifica | **No** lo instale. Póngase en contacto con soporte técnico — esto significa que el archivo no es una versión oficial. |
| `openssl failed to read public key` | Versión de OpenSSL muy antigua o dañada | Actualice el paquete `openssl`. |
| `invalid version: …` | Datos inesperados del servidor | Vuelva a ejecutarlo; póngase en contacto con soporte técnico si el problema persiste. |

## Inicio del servicio {#service-start}

| Mensaje | Causa | Solución |
|---|---|---|
| `service failed to start — check: journalctl -u nexcmp -n 50` | El panel no respondió a `/healthz` en 3 minutos | Revise el journal. Causas habituales: el puerto (por defecto 3000) ya está en uso (`ss -ltnp | grep 3000`) — vuelva a instalar con `--port`; archivos propiedad de root en `/var/lib/nexcmp` — ejecute `sudo nexcmp fix-owner`. |

## nginx y TLS {#nginx-and-tls}

| Mensaje | Causa | Solución |
|---|---|---|
| `DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS` | El registro A/AAAA falta o es incorrecto | Consulte [DNS y Cloudflare](https://nexcmp.com/es/docs/getting-started/dns-and-cloudflare/) y vuelva a ejecutarlo. |
| `certbot could not get a certificate yet — re-run the installer once DNS has settled` | Falló la validación de Let's Encrypt (puerto 80 bloqueado, DNS no propagado, límite de tasa) | Abra el puerto 80, espere a la propagación del DNS y vuelva a ejecutarlo. Revise `/var/log/letsencrypt/letsencrypt.log`. |
| `certbot could not renew now — keeping the existing certificate` | Fallo temporal en la renovación | Inofensivo; vuelva a ejecutarlo más tarde. |
| `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | Otro sitio de nginx entra en conflicto (mismo `server_name`, configuración duplicada) | Ejecute `sudo nginx -t` y corrija el conflicto; luego vuelva a ejecutarlo. |
| `apt-get could not install nginx` / `certbot` o `E: Failed to fetch … 404 Not Found` | El gestor de paquetes está bloqueado o el índice de paquetes del servidor está desactualizado (típico en una imagen de plantilla que no se ha actualizado desde hace tiempo) | Ejecute `sudo apt-get update`, espere a que finalice cualquier otro proceso de apt y luego vuelva a ejecutar el instalador. |
| `openssl could not create the self-signed certificate` | Problema con OpenSSL | Actualice `openssl` y vuelva a ejecutarlo. |

## Tras la instalación {#after-installation}

| Síntoma | Causa | Solución |
|---|---|---|
| El navegador no puede abrir `https://<domain>` | El DNS o TLS no están listos | `sudo nexcmp status`; use el [acceso de emergencia](https://nexcmp.com/es/docs/getting-started/cli-reference/#emergency-access). |
| `ERR_TOO_MANY_REDIRECTS` | Modo SSL **Flexible** de Cloudflare | Establezca **Full (strict)** — [detalles](https://nexcmp.com/es/docs/getting-started/dns-and-cloudflare/). |
| El asistente indica que el «setup code» es incorrecto | Error tipográfico o un código de una instalación anterior | Ejecute `sudo nexcmp status` y copie el código actual. |
| La licencia muestra HTTP 421 | Archivos en `/var/lib/nexcmp` propiedad de root | `sudo nexcmp fix-owner` y luego `sudo systemctl restart nexcmp`. |