🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solución de errores comunes al instalar PrestaShop en Syspanel

Actualizado el 15 de octubre de 2025

Introducción: Instalar PrestaShop en Syspanel sin dolores de cabeza

Montar una tienda online con PrestaShop es una decisión excelente, pero a veces el proceso de instalación puede presentar algunos tropiezos, especialmente si estás usando Syspanel (antes conocido como HestiaCP) para gestionar tu servidor. No te preocupes, es más común de lo que crees y casi todos los problemas tienen una solución sencilla.

En esta guía, vamos a repasar los errores PrestaShop Syspanel más frecuentes, cómo identificarlos y, sobre todo, cómo solucionar PrestaShop Syspanel de manera clara y paso a paso. Al final, incluiremos una sección de preguntas frecuentes para que resuelvas cualquier duda adicional.

[TIP] Si estás empezando, recuerda que Syspanel es el panel de control que usas para administrar tu servidor. Su acceso principal es a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Allí gestionarás bases de datos, dominios y archivos.

1. Error de conexión a la base de datos durante la instalación

Este es, sin duda, el fallo más común al instalar PrestaShop. Aparece un mensaje como "No se puede conectar a la base de datos" o "Error de autenticación".

¿Por qué ocurre?

  • Los datos de la base de datos (nombre, usuario, contraseña) no coinciden con los que creaste en Syspanel.
  • El usuario de la base de datos no tiene permisos suficientes.
  • El servidor de base de datos no está accesible (MySQL/MariaDB caído).

Cómo solucionarlo

  1. Verifica las credenciales en Syspanel

    • Accede a tu Syspanel (puerto 2106).
    • Ve a la sección Bases de Datos y localiza la que creaste para PrestaShop.
    • Anota exactamente el nombre de la base, el usuario y la contraseña. Cuidado con mayúsculas y caracteres especiales.

  2. Asegúrate de que el usuario tenga todos los permisos

    • En la misma sección, edita el usuario y marca todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Si no ves la opción, puedes ejecutar este comando en phpMyAdmin (accesible desde Syspanel): 
      GRANT ALL PRIVILEGES ON `tu_base_de_datos`.* TO 'tu_usuario'@'localhost';
FLUSH PRIVILEGES;

  3. Comprueba que el servicio MySQL esté activo

    • Desde el panel de Syspanel, en Servicios, verifica que MySQL/MariaDB esté en verde (activo). Si está rojo, reinícialo.

  4. Reintenta la instalación

    • Vuelve al asistente de PrestaShop e introduce los datos correctos. El servidor suele ser localhost (aunque a veces es 127.0.0.1).

[INFO] Si usas un servidor remoto, el host puede ser diferente. En Syspanel local, siempre usa localhost.

2. Error "500 Internal Server Error" o página en blanco

Este error es frustrante porque no da pistas claras. Aparece justo después de subir los archivos o al intentar acceder a la tienda.

Causas principales

  • Permisos incorrectos en archivos o carpetas.
  • Falta de módulos de PHP necesarios (como mysqli, gd, curl).
  • Archivo .htaccess corrupto o mal generado.

Pasos para resolverlo

  1. Revisa los permisos de archivos y carpetas

    • Conéctate por FTP o desde el Administrador de Archivos de Syspanel.
    • Las carpetas deben tener permisos 755 y los archivos 644.
    • Para aplicar de forma masiva, puedes usar estos comandos en la terminal (si tienes acceso SSH): 
      find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;
find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;

  2. Verifica los módulos de PHP

    • En Syspanel, ve a Configuración del servidor > PHP (o similar).
    • Asegúrate de que estén habilitados: mysqli, gd, curl, mbstring, openssl, zip, xml.
    • Si falta alguno, actívalo y reinicia el servicio PHP (en Servicios).

  3. Elimina o renombra el .htaccess

    • Temporalmente, renombra el archivo .htaccess en la raíz de PrestaShop a .htaccess_old.
    • Vuelve a cargar la página. Si funciona, el problema está en ese archivo. Luego, desde el panel de administración de PrestaShop, ve a Parámetros de la tienda > Tráfico y SEO y regenera el .htaccess.

[WARNING] No dejes el .htaccess eliminado permanentemente, ya que PrestaShop lo necesita para URLs amigables y seguridad.

3. Problemas con los requisitos de PHP (versión o extensiones)

PrestaShop es exigente con la versión de PHP. Si tu servidor tiene una versión obsoleta, la instalación se detendrá.

Síntomas

  • Mensaje: "Su versión de PHP es demasiado antigua".
  • Errores de funciones no definidas durante la instalación.

Solución

  1. Cambia la versión de PHP en Syspanel

    • Accede a Configuración del servidor > PHP.
    • Selecciona una versión compatible con tu PrestaShop. Las versiones 8.0, 8.1 u 8.2 suelen funcionar bien con las últimas versiones de PrestaShop 8.x.
    • Importante: Aplica el cambio al dominio donde instalas PrestaShop.

  2. Habilita extensiones faltantes

    • En la misma sección, busca y activa: fileinfo, json, intl, bcmath.
    • Guarda los cambios y reinicia el servicio PHP desde Servicios.

  3. Verifica el límite de memoria

    • A veces PrestaShop necesita más memoria. En Syspanel, puedes ajustar memory_limit a al menos 256M en la configuración de PHP.

[TIP] Si no ves la opción de cambiar versión PHP, consulta la documentación de Syspanel o contacta a tu proveedor de hosting. Generalmente está en Configuración Avanzada.

4. Error "No se puede escribir en la carpeta /cache" o permisos de escritura

Durante la instalación o al acceder al back office, PrestaShop necesita escribir en ciertas carpetas.

Causa

El usuario del servidor web (www-data, nobody, etc.) no tiene permisos de escritura en carpetas como cache, log, config, upload, img, etc.

Cómo arreglarlo

  1. Desde Syspanel (más fácil)

    • Ve al Administrador de Archivos.
    • Navega a la carpeta de PrestaShop.
    • Selecciona las carpetas problemáticas y haz clic en Permisos.
    • Asigna 755 a carpetas y 644 a archivos. Si el problema persiste, prueba con 775 temporalmente (menos seguro).

  2. Usando comandos (acceso SSH)

    chmod -R 755 /ruta/a/tu/prestashop/cache
chmod -R 755 /ruta/a/tu/prestashop/log
chmod -R 755 /ruta/a/tu/prestashop/config

  3. Cambia el propietario (si es necesario)

    • Si después de esto sigue sin funcionar, el propietario de los archivos puede ser incorrecto. Ejecuta: 
      chown -R www-data:www-data /ruta/a/tu/prestashop
    • Ajusta www-data por el usuario que use tu servidor (a veces nobody o admin).

[WARNING] No uses permisos 777 nunca, ya que expones tu tienda a vulnerabilidades de seguridad.

5. Error al subir archivos grandes (imágenes, temas, módulos)

PrestaShop maneja muchos archivos multimedia. Si tu límite de subida es pequeño, fallará.

Síntomas

  • Mensaje: "El archivo excede el tamaño máximo permitido".
  • La instalación de módulos o temas se queda colgada.

Solución

  1. Aumenta los límites en PHP

    • En Syspanel, ve a Configuración del servidor > PHP.
    • Modifica estos valores:
      • upload_max_filesize = 64M (o más)
      • post_max_size = 64M
      • max_execution_time = 300
      • max_input_time = 300

  2. Reinicia el servicio PHP

    • En Servicios, reinicia PHP-FPM o Apache/Nginx según corresponda.

  3. Si usas Nginx, ajusta también

    • En la configuración del dominio (dentro de Syspanel), añade en el bloque server: 
      client_max_body_size 64M;
    • Guarda y recarga Nginx desde Servicios.

6. Problemas con la URL de la tienda o redirecciones infinitas

Al terminar la instalación, la tienda no carga bien o te redirige a una URL incorrecta.

Causas

  • La URL configurada en PrestaShop no coincide con el dominio real.
  • El archivo settings.inc.php (en versiones antiguas) o la base de datos tienen valores incorrectos.
  • Conflictos con HTTPS/HTTP.

Pasos para corregirlo

  1. Accede a la base de datos

    • Desde Syspanel, abre phpMyAdmin.
    • Selecciona la base de datos de PrestaShop.
    • Busca la tabla ps_configuration (o prestashop_configuration).

  2. Corrige las URLs

    • Ejecuta estas consultas SQL (reemplaza tudominio.com por el tuyo): 
      UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name = 'PS_SHOP_DOMAIN';
UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name = 'PS_SHOP_DOMAIN_SSL';
    • Si no tienes SSL, usa http://.

  3. Limpia la caché de PrestaShop

    • Desde el administrador de archivos, elimina todo el contenido de la carpeta /cache/smarty/cache y /cache/smarty/compile.
    • También puedes reiniciar el servidor web desde Servicios en Syspanel.

[INFO] Si el problema persiste, revisa que tu dominio esté correctamente apuntado en Syspanel y que el SSL esté activo (puerto 443).

7. Error "Class not found" o "Fatal error" al instalar módulos

Al intentar instalar un módulo o tema, aparece un error de clase no encontrada.

Motivo

  • Incompatibilidad de versiones entre el módulo y PrestaShop.
  • Archivos del módulo corruptos o incompletos.
  • Falta de permisos en la carpeta de módulos.

Solución

  1. Verifica la compatibilidad

    • Revisa que el módulo sea para tu versión de PrestaShop (1.7, 8.x, etc.).
    • Descarga la última versión desde la fuente oficial.

  2. Reinstala el módulo manualmente

    • Descomprime el módulo en tu ordenador.
    • Sube la carpeta del módulo a /modules/ mediante FTP o el Administrador de Archivos de Syspanel.
    • Ve al back office de PrestaShop, a Módulos > Gestor de módulos, y busca el módulo para instalarlo.

  3. Aumenta el límite de memoria

    • Como en el punto 3, asegúrate de tener memory_limit en al menos 256M.

Preguntas Frecuentes (FAQ)

¿Puedo instalar PrestaShop en Syspanel sin conocimientos técnicos?

Sí, siguiendo los pasos básicos: crea un dominio, añade una base de datos, sube los archivos y ejecuta el asistente. Si encuentras errores, esta guía te ayudará.

¿Cómo accedo a phpMyAdmin desde Syspanel?

En el panel, busca la sección Bases de Datos y, al lado de tu base, verás un enlace a phpMyAdmin. También puedes ir directamente a https://tudominio.com:2106/phpmyadmin.

¿Qué hago si olvidé la contraseña de la base de datos?

En Syspanel, ve a Bases de Datos, edita el usuario y cambia la contraseña. Luego actualiza el archivo app/config/parameters.php de PrestaShop con la nueva contraseña.

¿Por qué mi tienda se ve en texto plano (sin CSS)?

  • Olvidaste activar las URLs amigables. Ve a Parámetros de la tienda > Tráfico y SEO y actívalas.
  • También revisa que los permisos de la carpeta themes sean 755.

¿Syspanel es lo mismo que HestiaCP?

Sí, Syspanel es la versión adaptada de HestiaCP. El acceso es por el puerto 2106 y la interfaz es muy similar.

Conclusión

Los errores PrestaShop Syspanel son comunes, pero con esta guía tienes las herramientas para solucionar PrestaShop Syspanel sin volverte loco. Recuerda siempre:

  • Verificar permisos (755 carpetas, 644 archivos).
  • Asegurar una versión de PHP compatible.
  • Usar las credenciales correctas de la base de datos.
  • No entrar en pánico: casi todo tiene solución.

Si después de seguir estos pasos sigues teniendo PrestaShop Syspanel fallos, revisa los logs del servidor en Syspanel > Registros o contacta al soporte técnico. ¡Buena suerte con tu tienda online!

[TIP] Guarda esta guía en favoritos. Te será útil cada vez que actualices PrestaShop o migres de servidor.

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel