FAQ sobre Syspanel: instalación y configuración básica

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con Syspanel, un potente panel de control para gestionar tu servidor web, y tienes algunas dudas sobre su instalación. No te preocupes, es completamente normal.

En esta guía extensa, vamos a resolver las preguntas frecuentes (FAQ) más comunes sobre la instalación de Syspanel. Vamos a cubrir desde los requisitos mínimos hasta cómo solucionar los problemas típicos. Todo explicado de forma sencilla, paso a paso, y sin tecnicismos complicados. ¡Vamos allá!

Requisitos Previos Antes de Instalar Syspanel

Antes de lanzarnos a la instalación, es fundamental asegurarnos de que tu servidor (o VPS) cumple con los requisitos básicos. Instalar Syspanel en un entorno incorrecto es una de las causas más comunes de errores.

¿Qué sistema operativo necesito?

Syspanel está diseñado para funcionar sobre sistemas operativos basados en Linux, específicamente en distribuciones Debian y Ubuntu. Es la base más estable y compatible.

Recomendado: Debian 11 (Bullseye) o Ubuntu 22.04 LTS.
Funciona también con: Debian 12 (Bookworm) y Ubuntu 24.04 LTS, aunque siempre es mejor usar las versiones LTS (Long Term Support) para mayor estabilidad.

[WARNING] ¡CUIDADO! No intentes instalar Syspanel en sistemas como CentOS, Rocky Linux, AlmaLinux, o versiones antiguas de Ubuntu (como 18.04 o inferiores). El instalador está diseñado exclusivamente para Debian/Ubuntu y fallará.

¿Cuánta memoria RAM y espacio en disco necesito?

Para que Syspanel funcione correctamente, necesitas un servidor con recursos mínimos decentes. No es un panel extremadamente pesado, pero tampoco funciona en una Raspberry Pi con 512MB de RAM.

Mínimo recomendado: 1 GB de RAM y 10 GB de espacio en disco.
Ideal para producción: 2 GB de RAM y 20 GB de espacio en disco SSD.
Procesador: Cualquier CPU moderna de 1 o 2 núcleos es suficiente.

Si tu servidor tiene menos de 1 GB de RAM, es probable que la instalación falle por falta de memoria o que el sistema quede extremadamente lento e inestable.

[TIP] Si tienes un VPS con 512MB de RAM, es mejor que consideres aumentar el plan de hosting o usar un panel más ligero. Syspanel necesita su espacio para respirar.

¿Necesito un dominio o IP pública?

Sí, para acceder a Syspanel necesitas una dirección IP pública estática o un dominio apuntando a tu servidor. El panel de control se accede a través del puerto 2106.

Ejemplo de acceso: https://tu-dominio.com:2106 o https://tu-ip-publica:2106.

No es necesario que tengas un dominio configurado para la instalación, pero sí para usarlo cómodamente.

Preguntas Frecuentes Durante la Instalación

Aquí están las dudas más habituales que surgen cuando ejecutas el script de instalación.

¿Cómo inicio la instalación de Syspanel?

La instalación es muy sencilla, todo se hace desde la terminal (línea de comandos). No hay interfaz gráfica durante el proceso. Debes conectarte a tu servidor por SSH (con un usuario con permisos de superusuario, normalmente root).

Conéctate a tu servidor vía SSH.
Actualiza el sistema: Es una buena práctica ejecutar estos comandos antes de instalar nada.
```
apt update && apt upgrade -y
```
Ejecuta el comando de instalación oficial:
```
bash <(curl -fsSL https://raw.githubusercontent.com/hestiacp/hestiacp/release/install/hst-install.sh)
```
- Este comando descarga el script principal y lo ejecuta. Asegúrate de tener curl instalado (si no, usa apt install curl -y).

[INFO] El proceso de instalación puede tardar entre 5 y 15 minutos, dependiendo de la velocidad de tu servidor y de tu conexión a internet. Durante este tiempo, el script descargará e instalará todos los componentes necesarios (Nginx, Apache, MySQL, PHP, etc.).

Me pide un correo electrónico y un nombre de host. ¿Qué pongo?

Durante la instalación, el script te hará dos preguntas clave:

Correo electrónico: Es la dirección de correo del administrador principal. Se usará para enviar notificaciones del sistema y para recuperar la contraseña del panel. Pon una dirección real a la que tengas acceso.
Nombre de host (hostname): Es el nombre que identificará a tu servidor en la red. Debe ser un FQDN (Fully Qualified Domain Name), es decir, un nombre de dominio completo.
- Correcto: server.midominio.com o vps.midominio.com.
- Incorrecto: midominio.com (sin subdominio) o solo server.

Si no tienes un dominio, puedes usar algo como server.tudominio.local, pero lo ideal es usar un subdominio real que apunte a la IP de tu servidor.

¿Qué pasa si el proceso de instalación se queda colgado o da error?

No te asustes. Los errores más comunes durante la instalación suelen ser por:

Falta de memoria RAM: Como mencionamos antes. Si ves errores de tipo "Killed" o "Out of memory", tu servidor no tiene suficiente RAM.
Problemas de conexión a internet: El script necesita descargar paquetes. Si tu servidor tiene problemas de DNS o de conectividad, fallará.
Sistema operativo no soportado: Si intentaste instalarlo en CentOS o Ubuntu 18.04, el script abortará automáticamente.

¿Qué hacer si falla?

Revisa el log de instalación: El script suele dejar un log en /root/hst-install.log o similar. Revisa las últimas líneas para ver el error concreto.
Aumenta la memoria RAM (si es posible). Si estás en un VPS, puedes cambiar el plan desde el panel de tu proveedor.
Limpia el sistema: Si la instalación falló a medias, ejecuta el script de desinstalación (si existe) o, mejor aún, reinstala el sistema operativo desde cero en tu proveedor de VPS. Es la forma más limpia de empezar de nuevo.

[WARNING] No intentes reinstalar Syspanel sobre una instalación fallida sin limpiar antes. Puedes dejar el sistema en un estado inconsistente y lleno de configuraciones rotas. Es preferible reinstalar el SO.

Preguntas Frecuentes Después de la Instalación

Una vez que el script termina sin errores, verás un mensaje en la terminal con la información de acceso. Aquí están las dudas que surgen justo después.

¿Cómo accedo al panel de Syspanel por primera vez?

Es muy sencillo. Abre tu navegador web favorito (Chrome, Firefox, Edge) y escribe la siguiente dirección:

https://LA_IP_DE_TU_SERVIDOR:2106

Recuerda:

Usa https, no http.
El puerto es el 2106.
Te aparecerá un aviso de seguridad (por el certificado SSL autofirmado). No te preocupes, es normal. Haz clic en "Avanzado" y luego en "Continuar a la dirección (no segura)" o la opción similar. Syspanel te generará un certificado real más adelante.

Las credenciales de acceso te las dio el script al final de la instalación. Normalmente son:

Usuario: admin
Contraseña: La que te mostró en pantalla (es una contraseña larga y segura). Guárdala en un lugar seguro porque solo la verás una vez.

No recuerdo la contraseña de admin. ¿Cómo la restablezco?

Si perdiste la contraseña, no te preocupes. Puedes restablecerla fácilmente desde la terminal de tu servidor.

Conéctate a tu servidor por SSH como usuario root.

Ejecuta el siguiente comando:

/usr/local/hestia/bin/v-change-user-password admin

El sistema te pedirá que introduzcas la nueva contraseña dos veces. Escríbela (no verás los caracteres por seguridad) y presiona Enter.
¡Listo! Ya puedes iniciar sesión en https://tu-ip:2106 con la nueva contraseña.

¿Cómo cambio el puerto de acceso por defecto (2106)?

Aunque el puerto 2106 es el estándar, puedes cambiarlo por seguridad o por conflictos con otros servicios.

Conéctate a tu servidor por SSH como root.
Edita el archivo de configuración del servidor web de Syspanel:
```
nano /usr/local/hestia/nginx/conf/nginx.conf
```
Busca la línea que dice listen 2106 ssl; y cambia el número 2106 por el puerto que desees (por ejemplo, 8443).
Guarda el archivo (Ctrl+O, luego Enter, luego Ctrl+X).
Reinicia el servicio de Syspanel para aplicar los cambios:
```
systemctl restart hestia
```
Ahora accederás a través de https://tu-ip:NUEVO_PUERTO.

[WARNING] Asegúrate de que el nuevo puerto no esté siendo usado por otro servicio y de que tu firewall (si lo tienes) permita el tráfico entrante a ese puerto.

¿Qué servicios instala Syspanel automáticamente?

Syspanel es un "todo en uno". Durante la instalación, configura e instala un stack completo de servidor web. Lo más importante que incluye es:

Servidor Web: Apache2 y Nginx (funcionan juntos, Nginx como proxy inverso y Apache para procesar PHP).
Base de Datos: MariaDB (una versión mejorada de MySQL).
PHP: Varias versiones de PHP (normalmente 8.x y 7.4).
DNS: Bind9 (para gestionar tus propios servidores DNS).
Correo: Exim (servidor de correo) y Dovecot (para gestionar buzones IMAP/POP3).
Estadísticas: AWStats y Webalizer.
Firewall: iptables (gestionado desde el propio panel).
SSL: Certbot (para instalar certificados SSL gratuitos de Let's Encrypt).

Todo esto se configura automáticamente para que funcione de manera óptima.

¿Es seguro exponer Syspanel al público en el puerto 2106?

Sí, es seguro por diseño. El puerto 2106 está dedicado exclusivamente a la interfaz de administración de Syspanel. Sin embargo, como buena práctica de seguridad, se recomienda:

Usar contraseñas fuertes para el usuario admin y para todos los usuarios que crees.
Mantener Syspanel actualizado. El propio panel te notificará cuando haya una nueva versión.
Configurar un firewall (desde el propio panel o desde tu proveedor de VPS) para restringir el acceso al puerto 2106 solo a direcciones IP de confianza (por ejemplo, la IP de tu oficina o casa).
Activar la autenticación de dos factores (2FA) si Syspanel lo soporta (en versiones recientes sí).

[TIP] Si solo tú vas a administrar el servidor, una buena práctica es permitir el acceso al puerto 2106 solo desde tu IP fija. Así, aunque alguien robe tu contraseña, no podrá acceder desde otra ubicación.

Solución de Problemas Comunes (Troubleshooting)

Aquí tienes una lista rápida de problemas y sus soluciones.

Error: "No se puede conectar al puerto 2106"

Causa 1: El firewall de tu servidor o de tu VPS está bloqueando el puerto.
- Solución: Revisa las reglas de tu firewall (si usas ufw, ejecuta ufw allow 2106). También revisa el panel de control de tu proveedor de nube (como AWS, DigitalOcean, Vultr) y asegúrate de que el puerto 2106 esté en la lista de puertos permitidos.
Causa 2: Syspanel no se está ejecutando.
- Solución: Conéctate por SSH y ejecuta systemctl status hestia. Si no está activo, usa systemctl restart hestia.

Error: "Página no encontrada" o "404" al acceder al panel

Causa: El servicio de Nginx de Syspanel no está funcionando correctamente.
- Solución: Desde SSH, ejecuta systemctl restart hestia-nginx. Si el error persiste, revisa los logs del servicio con journalctl -u hestia-nginx -n 50.

Error: "SSL_ERROR_BAD_CERT_DOMAIN" en el navegador

Causa: El certificado SSL autofirmado es para una IP o nombre de host que no coincide con el que estás usando.
- Solución: Es un error inofensivo. Simplemente, agrega una excepción de seguridad en tu navegador para continuar. Más adelante, puedes instalar un certificado SSL real desde el propio panel de Syspanel.

Conclusión y Consejos Finales

Instalar Syspanel es un proceso sencillo si sigues los pasos correctos y tienes el entorno adecuado. Recuerda siempre:

Usa Debian o Ubuntu como sistema operativo.
Ten al menos 1 GB de RAM.
Anota el correo y la contraseña que te da el instalador.
Accede siempre por HTTPS y puerto 2106.
Si algo falla, revisa los logs y, si es necesario, reinstala el sistema operativo antes de volver a intentarlo.

Espero que esta FAQ Syspanel te haya sido de gran ayuda. Si tienes alguna otra duda, no dudes en consultar la documentación oficial o contactar a tu proveedor de hosting. ¡Buena suerte con tu servidor!