Errores de instalación
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
| 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. |
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
| 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. |
no release available for this license yet | La licencia no tiene una versión descargable | Póngase en contacto con ventas; consulte Soporte. |
Descarga y verificación
| 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
| 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 |
nginx y 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 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
| 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. |
ERR_TOO_MANY_REDIRECTS | Modo SSL Flexible de Cloudflare | Establezca Full (strict) — detalles. |
| 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. |