Problemas comunes de instalación
El instalador está diseñado para no dejarte solo: si algo falla, te dice la fase exacta,
deja un paquete de diagnóstico en /root/nexia-diagnostic.tgz y nos envía un
reporte automático (sin secretos) para que podamos ayudarte. Estos son los tropiezos más
comunes y su salida.
Regla de oro: corrélo de nuevo
El instalador es idempotente: las fases completadas no se repiten. La mayoría de las fallas son transitorias (un mirror caído, un timeout de red). El primer paso siempre es:
sudo bash install.shCasos concretos
“Signature verification failed”
El paquete descargado no verifica contra la clave pineada. Casi siempre es una descarga corrupta: borrá y bajá de nuevo. Si persiste, no instales y escribinos — es exactamente lo que la verificación existe para impedir.
El sistema se queda “callado” varios minutos
Es normal en la compilación de FreeSWITCH (25–40 min en servers chicos) — desde v1.0.1 el
spinner muestra los segundos corriendo. Podés mirar el detalle en otra terminal:
tail -f /var/log/nexia-install.log
“Port conflicts” en el preflight
Hay otro software SIP o un panel web previo (Asterisk, FreePBX, nginx ajeno). NEXIA exige un servidor limpio: reinstalá el SO desde tu proveedor y arrancá de cero.
Falló en una fase intermedia y el re-run no la salta
Es lo esperado: la fase que falló se reintenta completa (solo las terminadas se saltan). Si la causa persiste, mirá las últimas líneas del log que el propio error te mostró.
El panel no carga por HTTPS
El certificado de una IP dura ~6 días por diseño de Let's Encrypt y se renueva solo
cada 6 horas (systemctl list-timers nexia-cert-renew). Si el server estuvo
apagado varios días, dale unos minutos tras encender o forzá:
systemctl start nexia-cert-renew
Si seguís trabado
/root/nexia-diagnostic.tgz (contiene el log y el estado de fases; nunca secretos).
Respondemos, y la causa se corrige para todos en el siguiente release.