Soluciones a errores de instalación de PrestaShop en Syspanel

Instalar PrestaShop en Syspanel puede parecer un proceso sencillo, pero es muy común encontrarse con errores que pueden frustrar hasta al usuario más paciente. En este artículo, vamos a desglosar los errores más frecuentes que ocurren durante la instalación de PrestaShop en Syspanel y, lo más importante, cómo solucionarlos paso a paso.

Si estás leyendo esto, probablemente ya hayas tenido algún problema o quieras prevenirlos. No te preocupes, la mayoría de estos errores tienen una solución clara y rápida. Vamos a ello.

1. Error de conexión a la base de datos: "No se puede conectar a la base de datos"

Este es, sin duda, el error más común. PrestaShop no puede establecer comunicación con la base de datos MySQL que creaste en Syspanel.

¿Por qué ocurre?

Generalmente, por tres razones:

El nombre de la base de datos está mal escrito.
El usuario no tiene permisos asignados a la base de datos.
La contraseña es incorrecta o tiene caracteres especiales que generan conflictos.

Solución paso a paso

Accede a Syspanel a través de tu navegador usando la dirección: https://tu-dominio.com:2106 (recuerda que el puerto es el 2106).
Ve a la sección Base de datos o MySQL.
Verifica el nombre exacto de la base de datos. Copia y pega, nunca escribas manualmente.
Asegúrate de que el usuario que vas a usar esté vinculado a esa base de datos. En Syspanel, suele aparecer un candado o un enlace para "vincular usuario".
Si no recuerdas la contraseña, cámbiala desde Syspanel (genera una nueva, preferiblemente sin símbolos raros como @, # o %).
Vuelve al instalador de PrestaShop y pega los datos exactos.

[WARNING] Atención: En Syspanel, el nombre de la base de datos y el usuario suelen llevar un prefijo (ej. usuario_tienda). No olvides incluir ese prefijo completo.

2. Error de permisos de archivos: "No se puede escribir en la carpeta"

PrestaShop necesita poder escribir en ciertas carpetas para instalar módulos, temas o subir imágenes. Si los permisos no son los correctos, el instalador se detiene.

¿Por qué ocurre?

Syspanel, por seguridad, asigna permisos restrictivos a las carpetas. PrestaShop necesita permisos 755 en directorios y 644 en archivos, pero a veces las carpetas config, cache o upload requieren 777 temporalmente.

Solución paso a paso

Conéctate a tu servidor vía FTP o usando el administrador de archivos de Syspanel (normalmente en la sección "Archivos").
Navega hasta la carpeta raíz donde instalaste PrestaShop (ej. public_html o tienda).
Selecciona todas las carpetas y ajusta los permisos a 755. Haz lo mismo con los archivos a 644.
Carpetas específicas que a veces necesitan 777:
- /img
- /mails
- /modules
- /themes
- /var/cache
- /config
Vuelve a ejecutar el instalador. Normalmente, el error desaparece.

[TIP] En Syspanel, puedes usar el botón "Cambiar permisos" en el administrador de archivos. Selecciona la carpeta, elige "755" y marca "Recursivo" para que afecte a todas las subcarpetas.

3. Error de versión de PHP: "PrestaShop no es compatible con esta versión de PHP"

PrestaShop es exigente con la versión de PHP. Si tu Syspanel tiene una versión muy antigua o muy nueva, el instalador te lo notificará.

¿Por qué ocurre?

PrestaShop 1.7 necesita PHP 7.1 a 7.4 (recomendado 7.3 o 7.4).
PrestaShop 8.x necesita PHP 8.0 o 8.1.
Si tienes PHP 5.6 o 8.2, el instalador fallará.

Solución paso a paso

Entra a Syspanel (puerto 2106).
Ve a la sección Configuración del servidor o PHP.
Busca la opción "Cambiar versión de PHP" para el dominio donde instalas PrestaShop.
Selecciona una versión compatible:
- Para PrestaShop 1.7: elige PHP 7.4.
- Para PrestaShop 8: elige PHP 8.1.
Guarda los cambios y espera unos segundos.
Reinicia el instalador de PrestaShop.

[INFO] Si no ves la opción de cambiar PHP, contacta con tu proveedor de hosting. En Syspanel, es un ajuste muy común y debe estar disponible.

4. Error de tiempo de ejecución (timeout): "El script tardó demasiado"

Al instalar módulos o durante la creación de la base de datos, el proceso puede exceder el tiempo máximo permitido por el servidor.

¿Por qué ocurre?

Syspanel tiene un límite de ejecución de scripts (normalmente 30 segundos). Si tu base de datos es grande o el servidor está lento, el instalador se congela.

Solución paso a paso

Aumenta el límite de tiempo desde el archivo php.ini de tu dominio en Syspanel.
Busca la línea max_execution_time y cámbiala a 300 (segundos).
También puedes modificar memory_limit a 256M o 512M.
Guarda el archivo y reinicia el servicio PHP desde Syspanel (suele haber un botón "Reiniciar PHP").
Vuelve a intentar la instalación.

[WARNING] Si no encuentras el php.ini, puedes crear un archivo llamado php.ini en la raíz de tu dominio y escribir:
max_execution_time = 300
memory_limit = 256M

5. Error de URL de la tienda: "La tienda no se muestra correctamente"

Después de instalar, la tienda se ve en blanco, con errores de CSS o redirige a una página de bienvenida de Syspanel.

¿Por qué ocurre?

La URL base no está bien configurada en el instalador.
El .htaccess no se generó correctamente.
Hay un conflicto con el SSL (HTTPS).

Solución paso a paso

Revisa la URL que pusiste durante la instalación. Debe ser https://tudominio.com o https://tudominio.com/tienda.
Accede a la base de datos desde Syspanel (phpMyAdmin).
Busca la tabla ps_configuration (o prestashop_configuration).
Localiza las filas PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL. Asegúrate de que tengan tu dominio correcto (sin http://).
Borra el archivo .htaccess de la carpeta raíz de PrestaShop (si existe) y luego ve a tu panel de administración (Back Office) a Parámetros de la tienda > Tráfico y SEO y haz clic en "Guardar" para regenerarlo.
Si usas SSL, en esa misma sección activa "Forzar SSL".

[TIP] Si no puedes acceder al Back Office, edita la base de datos directamente. Es la solución más rápida.

6. Error de módulos o temas: "No se pueden instalar complementos"

A veces, los módulos oficiales o de terceros fallan al instalarse, mostrando errores de dependencias o permisos.

¿Por qué ocurre?

Permisos insuficientes en la carpeta /modules.
PHP no tiene las extensiones necesarias (como curl, gd, mbstring).
El módulo no es compatible con tu versión de PrestaShop.

Solución paso a paso

Verifica los permisos de la carpeta /modules (debe ser 755 o 777 temporalmente).
Revisa las extensiones PHP desde Syspanel. Normalmente, en la sección "PHP" puedes ver una lista. Asegúrate de que estén activas: curl, gd, mbstring, openssl, pdo_mysql.
Desactiva temporalmente el caché de PrestaShop desde el Back Office (Parámetros avanzados > Rendimiento).
Vuelve a intentar la instalación del módulo. Si falla, descarga el módulo directamente desde el marketplace y súbelo manualmente por FTP a la carpeta /modules.

[INFO] Si el módulo requiere una versión específica de PHP, asegúrate de tenerla configurada (punto 3 de este artículo).

7. Error de memoria insuficiente: "Fatal error: Allowed memory size exhausted"

Este error aparece cuando PrestaShop intenta procesar una imagen grande o un módulo pesado y se queda sin memoria.

¿Por qué ocurre?

El límite de memoria por defecto en Syspanel suele ser bajo (64M o 128M). PrestaShop necesita al menos 256M para funcionar sin problemas.

Solución paso a paso

Aumenta la memoria en el archivo php.ini como explicamos en el error 4.
También puedes añadir esta línea al archivo config/defines.inc.php de PrestaShop (justo después de la línea define('_PS_MODE_DEV_', false);):
```
ini_set('memory_limit', '512M');
```
Guarda y recarga la tienda.

[WARNING] No modifiques defines.inc.php si no estás seguro. Mejor hazlo desde el php.ini de Syspanel.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en un subdominio con Syspanel?

Sí, perfectamente. Solo asegúrate de crear el subdominio en Syspanel (puerto 2106) y apuntar la instalación a la carpeta correcta (ej. /subdominio).

¿Qué hago si el instalador de PrestaShop no arranca?

Revisa que hayas subido todos los archivos correctamente y que el archivo index.php esté en la raíz. También verifica que no haya un index.html de Syspanel (puedes borrarlo o renombrarlo).

¿Cómo recupero mi tienda si el error es crítico?

Accede a la base de datos por phpMyAdmin y busca la tabla ps_employee para resetear la contraseña de administrador. También puedes restaurar una copia de seguridad desde Syspanel.

¿Syspanel tiene un instalador automático de PrestaShop?

Algunas versiones de Syspanel incluyen "Softaculous" o "Installatron". Si lo ves, úsalo, pero si prefieres hacerlo manual, sigue estos pasos.

Conclusión

Los errores instalación PrestaShop Syspanel son comunes, pero con esta guía tienes las herramientas para solucionar errores PrestaShop de forma rápida. Recuerda siempre:

Verificar permisos.
Ajustar la versión de PHP.
Configurar correctamente la base de datos.
Aumentar memoria y tiempo de ejecución.

Si a pesar de todo sigues teniendo Syspanel PrestaShop problemas, no dudes en contactar con el soporte técnico de tu hosting. ¡Buena suerte con tu tienda online!