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

Errores comunes al instalar PrestaShop en Syspanel y cómo solucionarlos

Actualizado el 23 de diciembre de 2025

Instalar PrestaShop puede parecer un proceso sencillo, pero cuando trabajas con un panel de control como Syspanel (antes conocido como HestiaCP), pueden aparecer ciertos errores PrestaShop Syspanel que frenan tu proyecto. No te preocupes: la mayoría tiene solución con unos pocos pasos. En esta guía te explicamos los fallos más comunes, por qué ocurren y cómo solucionar PrestaShop Syspanel de forma clara y sin complicaciones.

🔧 Requisitos previos antes de empezar

Antes de lanzarte a la instalación, asegúrate de que tu servidor cumple con los requisitos mínimos de PrestaShop. Muchos Syspanel PrestaShop fallos se deben precisamente a versiones incorrectas de PHP o a extensiones desactivadas.

[INFO] Syspanel gestiona múltiples versiones de PHP. Puedes cambiar la versión desde el panel, en la sección WEB > Editar dominio > Versión PHP. El acceso a Syspanel se realiza por el puerto 2106 (ejemplo: tudominio.com:2106).

Requisitos recomendados para PrestaShop 8.x:

  • PHP 7.4, 8.0 o 8.1 (evita PHP 8.2 si no está testeado).
  • MySQL 5.7+ o MariaDB 10.2+.
  • Extensiones PHP: curl, gd, json, mbstring, openssl, pdo_mysql, simplexml, zip, fileinfo, intl, bcmath.
  • Memoria PHP mínima: 256 MB (recomendado 512 MB).
  • ModRewrite activado en Apache/Nginx.

🚨 Error 1: Pantalla blanca o “500 Internal Server Error” al acceder a la instalación

Este es uno de los errores PrestaShop Syspanel más frecuentes. Ocurre justo después de descomprimir los archivos y tratar de abrir tudominio.com/install.

Causas principales:

  • Permisos incorrectos en carpetas o archivos.
  • Falta de la extensión zip o intl.
  • Límite de memoria PHP insuficiente.

Cómo solucionarlo:

  1. Verifica los permisos de archivos y carpetas. Conéctate por SSH o usa el gestor de archivos de Syspanel.

    • Las carpetas deben tener permisos 755.
    • Los archivos deben tener permisos 644.
    • La carpeta config/, cache/, log/ y upload/ deben ser escribibles (775).

  2. Aumenta la memoria PHP. Desde Syspanel, ve a WEB > Editar dominio > Configuración PHP y añade o modifica:

    memory_limit = 512M
max_execution_time = 180
upload_max_filesize = 64M
post_max_size = 64M

  3. Activa las extensiones necesarias. En la misma sección, asegúrate de que zip, intl, bcmath y fileinfo estén habilitadas.

  4. Revisa el log de errores. En Syspanel, en WEB > Logs de errores puedes ver el mensaje exacto. Si ves Class not found o Call to undefined function, es casi siempre una extensión faltante.

[TIP] Si después de todo sigue en blanco, prueba a descomprimir PrestaShop de nuevo. A veces la descarga se corrompe.

❌ Error 2: “No se puede conectar a la base de datos” durante la instalación

Este fallo aparece en el paso 3 del asistente de instalación, cuando introduces los datos de MySQL.

Causas:

  • Usuario o contraseña incorrectos.
  • La base de datos no existe o no tiene permisos asignados.
  • El servidor MySQL no acepta conexiones desde localhost (a veces por configuración de seguridad).

Pasos para resolverlo:

  1. Crea la base de datos y el usuario desde Syspanel.

    • Ve a BASE DE DATOS > Añadir base de datos.
    • Introduce un nombre, usuario y contraseña segura.
    • Marca la opción “Crear también un usuario” (si no está marcada, hazlo manualmente).
    • Asegúrate de que el host sea localhost (o 127.0.0.1).

  2. Verifica los datos en el asistente. Copia exactamente el nombre de la base de datos, usuario y contraseña. No uses espacios ni caracteres extraños.

  3. Prueba la conexión manualmente. Desde la terminal o el phpMyAdmin de Syspanel (puerto 2106, sección Base de datos), intenta conectar con esos datos. Si falla, revisa que el usuario tenga todos los privilegios sobre la base de datos.

  4. Revisa el archivo app/config/parameters.php (si ya existe). Si PrestaShop ya generó este archivo con datos incorrectos, bórralo y vuelve a empezar la instalación.

[WARNING] No uses el usuario root de MySQL. Crea siempre un usuario específico para PrestaShop. Es más seguro y evita conflictos.

🔄 Error 3: El instalador se queda pegado en “Configuración de la tienda” o no avanza

A veces la instalación parece congelarse en el último paso, justo cuando debería crear las tablas.

Causas:

  • Tiempo de ejecución de PHP demasiado bajo.
  • El servidor tiene un límite de memoria muy ajustado.
  • La versión de PHP no es compatible al 100%.

Soluciones:

  1. Aumenta el tiempo máximo de ejecución. En la configuración PHP del dominio (Syspanel), añade:

    max_execution_time = 300
max_input_time = 300

  2. Desactiva temporalmente el modo seguro de PHP (si está activo). En Syspanel, en la configuración avanzada de PHP, desmarca safe_mode si aparece.

  3. Usa PHP 8.0 o 7.4. Si estás con PHP 8.1 o 8.2 y el instalador se cuelga, prueba a bajar a 7.4. Muchos Syspanel PrestaShop fallos se solucionan simplemente cambiando la versión de PHP.

  4. Limpia la caché del navegador y reintenta. A veces el progreso se guarda en cookies y se bloquea. Abre una ventana de incógnito.

[TIP] Si el instalador se queda en “0%” durante mucho tiempo, revisa el log de errores de PHP. Puede que falte la extensión mysqli o pdo_mysql.

📁 Error 4: Error de escritura en la carpeta “cache” o “config”

Durante la instalación, PrestaShop necesita escribir archivos temporales. Si las carpetas no tienen permisos de escritura, verás un mensaje como: “No se puede escribir en /cache”.

Cómo arreglarlo:

  1. Concede permisos correctos desde Syspanel. Usa el gestor de archivos o SSH:

    chmod 755 -R /ruta/a/prestashop
chmod 775 -R /ruta/a/prestashop/cache
chmod 775 -R /ruta/a/prestashop/config
chmod 775 -R /ruta/a/prestashop/log
chmod 775 -R /ruta/a/prestashop/upload
chmod 775 -R /ruta/a/prestashop/img

  2. Cambia el propietario de los archivos. Si tu usuario de FTP no es el mismo que el usuario del servidor web, puede haber problemas. En Syspanel, asegúrate de que los archivos pertenezcan al usuario del dominio (normalmente admin o el nombre de tu cuenta). Puedes hacerlo desde WEB > Editar dominio > Permisos o con el comando:

    chown -R usuario:usuario /ruta/a/prestashop

  3. Desactiva el SELinux (si está activo y no sabes configurarlo). A veces bloquea la escritura aunque los permisos parezcan correctos. Consulta con tu administrador o hosting.

[INFO] En Syspanel, la ruta típica de los archivos del dominio es /home/nombreusuario/web/tudominio/public_html/. Ajusta los comandos según tu caso.

🌐 Error 5: URL incorrecta o redirecciones infinitas después de instalar

Una vez instalado, al acceder a la tienda, te redirige a localhost o a una URL antigua.

Causas:

  • Durante la instalación se configuró una URL incorrecta.
  • El archivo .htaccess no se generó bien.
  • El dominio no está apuntando correctamente en Syspanel.

Soluciones:

  1. Modifica la URL desde la base de datos. Conéctate a phpMyAdmin (desde Syspanel, puerto 2106) y busca la tabla ps_configuration (o ps_shop_url). Allí cambia los campos PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL por tu dominio real (sin http://).

  2. Regenera el archivo .htaccess.

    • Ve a la carpeta raíz de PrestaShop y elimina el archivo .htaccess (haz una copia de seguridad).
    • Accede a la URL de administración: tudominio.com/adminXXXXX/index.php?controller=AdminPerformance.
    • Ve a SEO y URLs > Configuración de URLs amigables y marca/desmarca la opción para forzar la regeneración.

  3. Verifica la configuración del dominio en Syspanel. Asegúrate de que el dominio esté correctamente configurado y que el DNS apunte a tu servidor. En Syspanel, en WEB > Editar dominio, revisa que el nombre del dominio sea exacto (sin www si no lo usas).

[WARNING] Si usas SSL, asegúrate de que en Syspanel tengas activado el certificado (sección SSL). PrestaShop necesita que la URL con HTTPS funcione correctamente.

🧩 Error 6: El módulo de instalación no reconoce la licencia o pide clave de activación

A veces, al intentar instalar un módulo o tema, PrestaShop pide una clave de activación que no tienes.

Causas:

  • El módulo es de pago y no has introducido la licencia.
  • El archivo de licencia no se ha subido correctamente.
  • Problemas con los permisos de la carpeta modules.

Cómo solucionarlo:

  1. Verifica que el módulo sea compatible con tu versión de PrestaShop. Muchos módulos antiguos no funcionan en versiones recientes.

  2. Sube el módulo manualmente.

    • Descomprime el módulo en tu ordenador.
    • Sube la carpeta del módulo a /modules/ mediante FTP o el gestor de archivos de Syspanel.
    • Asegúrate de que la carpeta tenga permisos 755 y los archivos 644.

  3. Borra la caché de PrestaShop. Ve a Parámetros avanzados > Rendimiento y limpia la caché. A veces el sistema no reconoce el módulo hasta que se refresca.

  4. Si el módulo pide licencia, contacta con el desarrollador. No intentes piratear módulos, ya que pueden contener malware y comprometer tu tienda.

[TIP] En Syspanel, puedes instalar módulos directamente desde el marketplace de PrestaShop si tu tienda está conectada a Internet. Ve a Módulos > Catálogo de módulos e inicia sesión con tu cuenta de PrestaShop.

🛠️ Error 7: Problemas con la tienda multidioma o multitienda

Al activar varios idiomas o tiendas, aparecen errores de URL o contenido duplicado.

Causas:

  • Las URL amigables no están bien configuradas.
  • Faltan traducciones.
  • Conflictos con el archivo .htaccess.

Soluciones:

  1. Configura las URL amigables correctamente. En SEO y URLs, asegúrate de que cada idioma tenga su propia URL (ejemplo: /es/, /en/).

  2. Instala los paquetes de idioma desde el back office. Ve a Internacional > Localización > Idiomas y descarga los que necesites.

  3. Si usas multitienda, revisa que cada tienda tenga su propio dominio o subdominio configurado en Syspanel. En Parámetros avanzados > Multitienda, asigna correctamente los dominios.

  4. Regenera el .htaccess después de cualquier cambio en las URLs.

[INFO] En Syspanel, para subdominios, debes crear un nuevo dominio en WEB > Añadir dominio y apuntarlo a la misma carpeta o a una subcarpeta específica.

📝 Preguntas frecuentes (FAQ)

¿Por qué aparece “Error 403 Forbidden” al acceder a la instalación?

Esto ocurre porque el archivo install/index.php no tiene permisos de ejecución o porque hay un .htaccess que bloquea el acceso. Temporalmente, renombra el .htaccess a .htaccess.bak y vuelve a intentar.

¿Cómo cambio la versión de PHP en Syspanel?

Accede a Syspanel por el puerto 2106, ve a WEB > Editar dominio > Versión PHP y selecciona la que necesites. Guarda los cambios.

¿Qué hago si el instalador de PrestaShop no encuentra la extensión intl?

En Syspanel, en la configuración PHP del dominio, activa intl desde la lista de extensiones. Si no aparece, contacta con tu proveedor de hosting para que la instale a nivel de servidor.

¿Puedo instalar PrestaShop en un subdirectorio (ej: /tienda)?

Sí. Simplemente sube los archivos a una subcarpeta dentro de public_html/ y configura el dominio correctamente en Syspanel. Luego, durante la instalación, usa la URL completa con la subcarpeta.

¿Cómo accedo a phpMyAdmin desde Syspanel?

Ve a BASE DE DATOS > phpMyAdmin o directamente a tudominio.com:2106/phpmyadmin. Usa las credenciales de la base de datos que creaste.

✅ Resumen final

Los errores PrestaShop Syspanel son comunes, pero casi siempre tienen una solución sencilla si sabes dónde mirar. Recuerda:

  • Revisa siempre los permisos y la versión de PHP.
  • Crea la base de datos desde el panel (nunca uses root).
  • Aumenta los límites de memoria y tiempo de ejecución.
  • Si algo falla, consulta los logs de errores en Syspanel.

Con esta guía, solucionar PrestaShop Syspanel ya no será un dolor de cabeza. Si después de todo sigues teniendo problemas, contacta con tu proveedor de hosting o con el equipo de soporte de Syspanel. ¡Buena suerte con tu tienda online!

¿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