FAQ Syspanel: Errores comunes y cómo solucionarlos

¿Qué es Syspanel y por qué a veces da problemas?

Syspanel es el nombre que le hemos dado a nuestro panel de control basado en HestiaCP, una herramienta moderna y potente para gestionar tu hosting. A través de Syspanel puedes administrar cuentas de correo, bases de datos, dominios, archivos y mucho más desde un solo lugar, accediendo por el puerto 2106 (por ejemplo: https://tudominio.com:2106).

Sin embargo, como cualquier software, a veces pueden aparecer errores típicos que pueden desconcertar a usuarios nuevos. No te preocupes: la mayoría tienen solución rápida. En esta FAQ (Preguntas Frecuentes) vamos a recorrer los errores comunes y sus soluciones paso a paso, para que puedas resolverlos sin necesidad de ser un experto técnico.

Error 1: No puedo acceder a Syspanel (página no carga)

¿Por qué ocurre?

El acceso a Syspanel se realiza mediante una conexión segura por el puerto 2106. Si no puedes cargar la página, suele deberse a:

El puerto 2106 está cerrado en tu firewall o en el de tu servidor.
El dominio no apunta correctamente al servidor.
El navegador bloquea la conexión por ser un puerto no estándar.

Solución paso a paso

Verifica la URL correcta: Asegúrate de escribir https://tudominio.com:2106 (con la «s» de seguro y los dos puntos antes del puerto).
Comprueba el firewall de tu servidor: Si tienes acceso a la terminal, ejecuta sudo ufw status (en Ubuntu) para ver si el puerto 2106 está permitido. Si no aparece, agrégalo con sudo ufw allow 2106.
Prueba desde otro navegador o dispositivo: A veces extensiones o configuraciones locales bloquean puertos no comunes. Prueba con Chrome en modo incógnito o desde un móvil.
Revisa los registros DNS: Asegúrate de que tu dominio tenga un registro A que apunte a la IP de tu servidor. Puedes usar herramientas online como whatsmydns.net.

[TIP] Si después de todo no accedes, contacta con tu proveedor de hosting y pide que verifiquen que el panel esté activo y el puerto abierto.

Error 2: «Contraseña incorrecta» aunque estoy seguro de que es la correcta

¿Por qué ocurre?

Syspanel almacena las contraseñas de forma cifrada. Si cambiaste la contraseña recientemente o la escribiste mal, el sistema no te dejará entrar. También puede ser que la sesión haya caducado o que tengas un bloqueo por intentos fallidos.

Solución paso a paso

Usa la opción «Olvidé mi contraseña»: En la pantalla de inicio de Syspanel, haz clic en el enlace de recuperación. Recibirás un correo para restablecerla.
Revisa mayúsculas y caracteres especiales: Las contraseñas distinguen mayúsculas/minúsculas. Cópiala exactamente como la creaste.
Espera 15 minutos si hay bloqueo: Tras varios intentos fallidos, Syspanel bloquea temporalmente la IP. Espera un cuarto de hora y vuelve a intentar.
Solicita un reset desde el servidor: Si no recibes el correo, pide a tu soporte técnico que reinicie tu contraseña desde la terminal con el comando v-change-user-password usuario nueva_contraseña.

[WARNING] Nunca compartas tu contraseña con nadie. Si sospechas que alguien más la sabe, cámbiala inmediatamente.

Error 3: Los cambios en mi sitio web no se ven reflejados

¿Por qué ocurre?

Este es uno de los errores comunes más frustrantes. Puede deberse a:

Caché del navegador o del servidor.
El archivo que modificaste no está en la carpeta correcta.
El dominio no está apuntando al servidor correcto.

Solución paso a paso

Limpia la caché del navegador: En Chrome, presiona Ctrl + Shift + Supr y selecciona «Caché de imágenes y archivos». Luego recarga la página con Ctrl + F5.
Desactiva plugins de caché temporalmente: Si usas un CMS como WordPress, desactiva los plugins de caché (por ejemplo, WP Super Cache) y vuelve a probar.
Verifica la ruta del archivo: En Syspanel, ve a la sección Web > Dominio > Editar y confirma que la raíz del sitio (/home/usuario/web/tudominio/public_html) sea donde estás subiendo tus archivos.
Comprueba los registros DNS: Si cambiaste de servidor, los DNS pueden tardar hasta 48 horas en propagarse. Usa ping tudominio.com en tu terminal para ver a qué IP responde.

[INFO] Si tu sitio usa CDN (como Cloudflare), la caché puede estar en sus servidores. Purga la caché desde el panel de Cloudflare.

Error 4: No puedo crear cuentas de correo en Syspanel

¿Por qué ocurre?

Syspanel permite crear correos ilimitados en la mayoría de planes, pero a veces el límite de almacenamiento o una configuración incorrecta lo impide.

Solución paso a paso

Revisa el límite de cuentas: En la sección Mail > Añadir cuenta, verifica que no hayas alcanzado el máximo permitido por tu plan.
Comprueba el espacio en disco: Si el servidor está lleno, no podrás crear nuevos buzones. Ve a Estadísticas en Syspanel para ver el uso de disco.
Verifica el nombre de dominio: Asegúrate de que el dominio esté correctamente añadido en Web y que tenga registros MX válidos.
Prueba con un nombre de usuario simple: Evita caracteres especiales o nombres muy largos. Por ejemplo, info@tudominio.com suele funcionar bien.

[TIP] Si el error persiste, revisa los logs del servidor de correo desde la terminal con tail -f /var/log/mail.log. Busca mensajes como «mailbox quota exceeded».

Error 5: La base de datos no se conecta a mi aplicación

¿Por qué ocurre?

Las aplicaciones (como WordPress, Joomla, etc.) necesitan credenciales correctas de base de datos. Un error típico es confundir el host, usuario o contraseña.

Solución paso a paso

Verifica las credenciales en el archivo de configuración: Por ejemplo, en WordPress, revisa wp-config.php. Busca las líneas DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
El host correcto: En Syspanel, el host suele ser localhost o 127.0.0.1. Si tu base de datos está en otro servidor, usa la IP correspondiente.
Asegúrate de que la base de datos exista: En Syspanel, ve a Bases de Datos y confirma que el nombre y usuario coincidan exactamente.
Prueba la conexión manualmente: Desde la terminal, ejecuta mysql -u usuario -p -h localhost e ingresa la contraseña. Si no conecta, el error está en las credenciales o en los permisos.

[WARNING] Si cambias la contraseña de la base de datos, actualízala también en el archivo de configuración de tu aplicación, o dejará de funcionar.

Error 6: El panel se ve en blanco o con errores de JavaScript

¿Por qué ocurre?

Syspanel utiliza tecnologías web modernas. Si tu navegador está desactualizado o tienes extensiones que bloquean scripts, el panel puede no cargar correctamente.

Solución paso a paso

Actualiza tu navegador: Usa la última versión de Chrome, Firefox o Edge.
Desactiva bloqueadores de anuncios y scripts: Extensiones como uBlock Origin o NoScript pueden interferir. Desactívalos temporalmente para Syspanel.
Limpia la caché y cookies del navegador: Como en el error 3, limpia todo el historial reciente.
Prueba en modo incógnito: Esto desactiva todas las extensiones. Si funciona, el problema es una extensión.

[INFO] Si el error persiste, puede ser un problema del servidor. Contacta al soporte y menciona que ves una página en blanco o errores de consola (presiona F12 para ver la consola de JavaScript).

Error 7: No puedo subir archivos grandes por FTP o el gestor de archivos

¿Por qué ocurre?

Syspanel tiene límites de tamaño de archivo por defecto para proteger el servidor. Si intentas subir un archivo de más de 50 MB, puede fallar.

Solución paso a paso

Usa FTP en lugar del gestor web: Herramientas como FileZilla permiten subir archivos grandes sin límite por tiempo de ejecución.
Aumenta el límite desde Syspanel: Ve a Configuración del servidor > Límites y ajusta upload_max_filesize y post_max_size (por ejemplo, a 128M). Guarda y reinicia Apache/Nginx.
Divide archivos grandes: Si no puedes cambiar el límite, comprime el archivo en partes más pequeñas (por ejemplo, con WinRAR o 7-Zip) y súbelas por separado.
Verifica el espacio en disco: Si el disco está lleno, no podrás subir nada. Libera espacio eliminando archivos temporales o backups viejos.

[TIP] Para bases de datos grandes, usa la opción «Importar» desde phpMyAdmin, que soporta archivos de hasta 2 GB si configuras bien el límite.

Error 8: El certificado SSL no se renueva automáticamente

¿Por qué ocurre?

Syspanel incluye Let's Encrypt para SSL gratuito, pero a veces la renovación falla por problemas de validación del dominio.

Solución paso a paso

Verifica que el dominio apunte al servidor: La renovación necesita que el dominio resuelva a la IP del servidor. Usa dig tudominio.com para confirmar.
Renueva manualmente: En Syspanel, ve a Web > Dominio > Editar y haz clic en «Renovar SSL». Si falla, mira el mensaje de error.
Abre el puerto 80: Let's Encrypt necesita el puerto 80 abierto para la validación HTTP. Asegúrate de que no esté bloqueado.
Revisa los logs de renovación: Ejecuta en la terminal tail -f /var/log/letsencrypt/letsencrypt.log para ver el motivo exacto del fallo.

[WARNING] Si el SSL caduca, tu sitio mostrará un aviso de «No seguro» en el navegador. Renueva antes de que expire.

Error 9: Syspanel no envía correos (ni de sistema ni de usuarios)

¿Por qué ocurre?

El servicio de correo puede estar detenido, mal configurado o bloqueado por el proveedor.

Solución paso a paso

Reinicia el servicio de correo: Desde la terminal, ejecuta systemctl restart exim4 (o postfix, según tu servidor).
Verifica los registros DNS: Tu dominio debe tener registros MX, SPF y DKIM. Syspanel los genera automáticamente, pero puedes revisarlos en Mail > Editar dominio.
Comprueba la cola de correo: Ejecuta mailq para ver si hay mensajes pendientes. Si hay muchos, puede que el servidor esté siendo marcado como spam.
Prueba con una cuenta externa: Envía un correo desde Gmail a tu cuenta de Syspanel y viceversa. Si no llega, revisa la carpeta de spam.

[TIP] Si usas servicios como SendGrid o Mailgun, puedes configurarlos como relay en Syspanel para mejorar la entrega.

Error 10: El panel se queda cargando o da timeout

¿Por qué ocurre?

Un servidor sobrecargado, recursos insuficientes o un proceso colgado pueden hacer que Syspanel no responda.

Solución paso a paso

Reinicia el panel desde la terminal: Ejecuta systemctl restart hestia (Syspanel se basa en HestiaCP). Esto suele liberar procesos atascados.
Monitorea el uso de recursos: Usa top o htop para ver si la CPU o la RAM están al 100%. Si es así, puede que necesites más recursos.
Revisa los logs del panel: En /var/log/hestia/ busca archivos como error.log para identificar el problema.
Aumenta el límite de memoria PHP: Si el panel usa PHP, edita php.ini y sube memory_limit a 256M o 512M.

[WARNING] Si el timeout es constante, contacta a tu proveedor de hosting para que verifique el estado del servidor.

Consejos finales para evitar errores comunes en Syspanel

Mantén todo actualizado: Syspanel y los servicios del servidor (Apache, Nginx, PHP) deben estar en sus últimas versiones estables.
Haz backups regulares: Usa la función de backup de Syspanel (en Backup) para guardar tus sitios y bases de datos al menos una vez por semana.
Usa contraseñas seguras: Combina mayúsculas, minúsculas, números y símbolos. Evita fechas de nacimiento o palabras comunes.
No modifiques archivos del sistema sin saber: Cambiar configuraciones de Syspanel desde la terminal puede romper el panel. Siempre que puedas, usa la interfaz web.
Documenta tus cambios: Si haces algo fuera de lo común, anótalo. Así, si algo falla, sabrás qué revertir.

Si después de seguir estas soluciones el error persiste, no dudes en contactar a nuestro equipo de soporte. Recuerda incluir:

El mensaje de error exacto.
El paso donde falla.
Una captura de pantalla (si es posible).

¡Estamos aquí para ayudarte a que tu experiencia con Syspanel sea fluida y sin dolores de cabeza!