NetWispDOCS
Primeros pasos

Instalar NetWisp en un VPS limpio

Los requisitos del servidor, dónde conviene instalarlo y la línea de comando que lo deja funcionando.

## Qué servidor necesitas

Lo que manda son los núcleos, no el disco. Y lo que decide cuántos hacen falta es si vas a gestionar los equipos de tus abonados por TR-069.

Con TR-069

Hasta 100 abonados
2 núcleos, 4 GB
Hasta 300
4 núcleos, 8 GB
Hasta 500
4 núcleos, 8 GB
Hasta 1000
8 núcleos, 16 GB

El equipo de cada abonado saluda al panel cada pocos minutos. Con muchos abonados esos saludos son la mayor parte del trabajo del servidor.

Sin TR-069

Hasta 100 abonados
2 núcleos, 2 GB
Hasta 300
2 núcleos, 4 GB
Hasta 500
2 núcleos, 4 GB
Hasta 1000
4 núcleos, 8 GB

Si solo facturas, cortas y reconectas, y miras tus ONU desde la OLT, con la mitad de máquina te sobra.

Medido sobre una instalación real de 99 abonados con 82 equipos gestionados por TR-069.

Del disco importa la velocidad, no el tamaño: tiene que ser SSD, mejor NVMe. El panel guarda cada dato en el disco antes de darlo por bueno, y en un disco lento eso se nota en todo. Con 40 GB vas sobrado hasta los 300 abonados, y con 120 GB hasta los mil.

Si te quedas corto, el panel va lento pero no se cae, y ampliar un VPS son minutos.

## En un VPS o en un servidor de tu local

EN UN VPS Tú y tus cobradores desde cualquier sitio El panel, en el VPS fuera de tu local VPN Tu local OLT, MikroTik, fibra Se va la luz en tu local y el panel sigue en pie EN UN SERVIDOR EN TU LOCAL Tú y tus cobradores desde cualquier sitio IP fija Tu local: el panel, la OLT y el MikroTik, todo junto un solo punto de fallo Se va la luz y te quedas sin panel y sin cobrar La diferencia no es la potencia de la máquina. Es dónde vive el panel cuando tu local se queda a oscuras.
Lo que cambia entre las dos opciones es qué se cae contigo, no cuántos núcleos tiene la máquina.

Un VPS

Lo recomendado, y lo que usa casi todo el mundo

A favor

  • Sigue en pie aunque se corte la luz o el internet en tu local
  • Ampliar núcleos y memoria son minutos, sin reinstalar nada
  • Trae IP fija de serie, así que el candado HTTPS sale solo
  • El proveedor respalda la máquina entera, además del respaldo diario del panel
  • Tus cobradores entran desde donde estén sin abrir nada en tu red

En contra

  • Pagas una mensualidad, entre 10 y 40 dólares según el tamaño
  • Necesitas internet para entrar al panel
  • Llega a tu OLT y a tu MikroTik por VPN, que el instalador deja montada

Un servidor en tu local

Tiene sentido si ya tienes máquina, energía y enlace de respaldo

A favor

  • No pagas mensualidad, solo la luz
  • El panel habla con tu OLT por la red de casa, sin VPN de por medio
  • Tus datos no salen de tu oficina en ningún momento

En contra

  • Si se va la luz o el internet, te quedas sin panel y sin poder cobrar
  • Necesitas IP fija para entrar desde fuera y para el certificado
  • El respaldo de la máquina corre por tu cuenta
  • Ampliar memoria o disco significa apagar y abrir el equipo
  • Si el local se inunda o te lo roban, se va todo junto

## Ahora sí, la instalación

NetWisp se instala solo. Tú pones el servidor, el instalador pone todo lo demás.

  1. Contrata el VPS con Ubuntu 22.04, Ubuntu 24.04 o Debian 12. Versiones anteriores no sirven: el instalador se detiene y te avisa, porque el repositorio oficial ya no publica PHP 8.4 para Ubuntu 20.04 ni anteriores. Casi todos los proveedores dejan reinstalar el VPS con otra imagen desde su panel.
  2. Entra por SSH y ponte como root con sudo -i.
  3. Pega esta línea y dale Enter:

wget -qO install https://license.networksolutionsperu.com/updates/netwisp/install && bash install

  1. Te preguntará Puerto [80]. Pulsa Enter para dejar el 80. Solo escribe otro, por ejemplo 8080, si ese VPS ya tiene el 80 ocupado por otro servicio.
  2. Espera. El instalador detecta solo la IP del servidor y va por ocho pasos: paquetes base y PHP, copia del código, backend y base de datos, panel, permisos, nginx, permisos de php-fpm para la VPN, y firewall con HTTPS. Además deja montados el enlace de WhatsApp, la VPN para routers detrás de NAT, el respaldo diario y las actualizaciones automáticas cada 6 horas.
  3. Lee el final. Si todo quedó bien imprime NetWisp desplegado: con la dirección. Si algo esencial falló imprime LA INSTALACIÓN NO QUEDÓ COMPLETA y lista qué falta. En ese caso no abras el panel: arregla lo indicado y vuelve a lanzar el instalador, que se puede relanzar sobre la misma caja sin perder datos.
  4. Abre esa dirección en el navegador. Verás el asistente de instalación.

Si ya tienes un dominio apuntando a ese VPS, lánzalo así para que emita el certificado solo:

wget -qO install https://license.networksolutionsperu.com/updates/netwisp/install && NETWISP_DOMAIN=panel.miisp.com bash install

Con dominio te pedirá además el Email para el certificado HTTPS. Pulsa Enter y usará admin@ tu dominio.

## Lo siguiente NO es tu OLT

Aquí es donde casi todo el mundo se equivoca. Recién instalado, lo primero que hay que conectar es tu MikroTik, no la OLT.

1. Instalas en el VPS 2. Tu MikroTik Antes que nada más de la red exige 3. El contrato de cada cliente 4. Tu OLT y sus ONU se vinculan al contrato 5. El TR-069 el equipo de su casa 6. La facturación cortes y reconexiones sin router, el corte y la reconexión fallan
Sin el MikroTik conectado no puedes crear contratos, y sin contrato una ONU no se vincula a nadie.

El motivo es que el contrato de cada cliente exige un router asignado. Sin él no puedes dar de alta a nadie, y sin contrato una ONU autorizada no se vincula a ningún abonado. Además el corte por deuda y la reactivación viajan por el router: un contrato sin router asignado da el corte por fallido y el abonado se queda navegando.

Así que el orden es: conectas tu MikroTik, creas tus planes y tus clientes, y recién entonces das de alta la OLT y empiezas a autorizar ONU.

Sigue por Conectar tu MikroTik al panel, en la sección Routers y servicio.