Wiki de instalación.

Requisitos mínimos

El disco de datos debe dimensionarse según tasa de flujos, colectores y días de retención. Se recomienda XFS o ext4.

Instalar las herramientas básicas

Entra a la consola de Debian como root y ejecuta:

apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip

Descargar, verificar e instalar

Este bloque descarga el instalador estable, descarga su checksum, realiza la verificación estricta y ejecuta el instalador oficial.

curl -fsSLo klk-flow-install.sh https://licencia.airtime.com.do/downloads/klk-flow/install.sh &&
curl -fsSLo klk-flow-install.sh.sha256 https://licencia.airtime.com.do/downloads/klk-flow/install.sh.sha256 &&
sha256sum --check --strict klk-flow-install.sh.sha256 &&
bash klk-flow-install.sh

Instalar con dominio y HTTPS

Si el DNS del dominio ya apunta a la IP pública del servidor:

bash klk-flow-install.sh --domain flow.midominio.com --email admin@midominio.com

Después de instalar

1. 1
   Abre la URL indicada al terminar: http://IP_PRIVADA o el dominio configurado.
2. 2
   Entra con el usuario inicial indicado por el instalador y cambia inmediatamente la contraseña.
3. 3
   En Almacenamiento, configura el disco adicional sin tocar el disco del sistema.
4. 4
   Crea y activa la licencia del colector en el panel de licencias.
5. 5
   Configura cada MikroTik para exportar NetFlow/IPFIX hacia la IP privada y el puerto UDP asignado.

Requisitos recomendados

Para la VPN de gestión WireGuard, permite o redirige también UDP 51820. No instales Node.js, MongoDB, Nginx ni paquetes de KLK‑ISP manualmente: el bootstrap prepara todo.

Ejecutar un solo comando

Copia este único comando en la consola root. Te pedirá dominio, correo administrativo opcional y código de activación. El código se guarda temporalmente con permisos privados y se elimina al terminar.

bash -c 'set -Eeuo pipefail; umask 077; read -rp "Dominio del panel: " KLK_DOMAIN </dev/tty; read -rp "Correo administrativo (opcional): " KLK_EMAIL </dev/tty; read -rsp "Código de activación: " KLK_CODE </dev/tty; printf "\n" >/dev/tty; CODE_FILE=/root/.klk-isp-activation-code; INSTALLER=/root/klk-isp-install.sh; trap "rm -f -- \"$CODE_FILE\" \"$INSTALLER\"" EXIT; printf "%s\n" "$KLK_CODE" >"$CODE_FILE"; unset KLK_CODE; curl --fail --silent --show-error --proto "=https" --tlsv1.2 --connect-timeout 15 --max-time 120 --max-filesize 1048576 https://license.airtime.com.do/bootstrap/install.sh -o "$INSTALLER"; printf "%s  %s\n" "dcd43733de49cd91255f48576fc182ef5f974fc51b368bc82f9c38468e9c5039" "$INSTALLER" | sha256sum --check --strict; chmod 700 "$INSTALLER"; ARGS=(--domain "$KLK_DOMAIN" --activation-code-file "$CODE_FILE" --accept-acme-terms); [[ -z "$KLK_EMAIL" ]] || ARGS+=(--email "$KLK_EMAIL"); "$INSTALLER" "${ARGS[@]}"'

El comando verifica el SHA‑256 del bootstrap. Después, el bootstrap instala el runtime necesario, activa la licencia, valida las firmas Ed25519 del catálogo y descarga exclusivamente la versión estable autorizada por license.airtime.com.do.

Qué instala automáticamente

1. 1
   Dependencias del sistema y runtime Node.js oficial fijado y verificado.
2. 2
   Última versión estable de KLK‑ISP obtenida del catálogo firmado.
3. 3
   Base de datos local, Nginx, certificado HTTPS, servicios systemd y WireGuard.
4. 4
   Identidad privada de la instalación, activación de licencia y cola de actualizaciones.
5. 5
   Administrador inicial; las credenciales quedan únicamente en /var/lib/klk-isp-fresh-install/first-login.txt, accesible por root.

Requisitos mínimos

Descomprimir el paquete

cd /root
unzip GPON-MANAGER-*.zip
cd gpon-manager

Ejecutar como root

chmod 700 INSTALAR-DEBIAN13.sh
bash INSTALAR-DEBIAN13.sh

La instalación prepara Node.js, PostgreSQL, Nginx, el concentrador WireGuard y los servicios de sondeo.

Después de instalar

1. 1
   Crea el administrador y registra la licencia de la primera OLT.
2. 2
   Configura la VPN o ruta privada hacia la red de gestión.
3. 3
   Registra la OLT con credenciales de lectura y ejecuta el primer sondeo.
4. 4
   Comprueba inventario, tarjetas, puertos, ONT y niveles ópticos.
5. 5
   Autoriza escrituras solo después de validar el adaptador y el firmware en una OLT canaria.

Requisitos mínimos

Preparar el paquete

cd /root
unzip fibra-planner-debian-*.zip
cd fibra-planner

Instalar el servicio

chmod 700 install-debian.sh
sudo bash install-debian.sh

El instalador agrega Docker si hace falta, construye la aplicación y conserva los datos en un volumen persistente.

Después de instalar

1. 1
   Valida el acceso interno en http://IP_PRIVADA:3080.
2. 2
   Cambia la contraseña y crea una copia de seguridad inicial.
3. 3
   Para acceso público, configura Nginx y HTTPS delante del servicio.
4. 4
   Restringe el puerto 3080 para que solo sea accesible desde el proxy o la red privada.
5. 5
   Crea una zona de prueba y valida la exportación GeoJSON.