Errores comunes al instalar PrestaShop en Syspanel | Soluciones

¿Por qué PrestaShop da errores al instalarlo en Syspanel?

Instalar PrestaShop es, en teoría, un proceso sencillo: descargar, subir, crear base de datos y ejecutar el instalador. Sin embargo, en la práctica, es muy común toparse con pantallas blancas, errores de permisos, problemas con PHP o conflictos con el servidor web. Si estás usando Syspanel como panel de control (recuerda que el acceso es a través del puerto 2106), es probable que algunos errores tengan que ver con la configuración específica de este entorno.

No te preocupes. En esta guía completa vamos a repasar los errores PrestaShop más frecuentes durante la instalación en Syspanel, y te daremos la solución errores PrestaShop paso a paso. Al final, tendrás tu tienda funcionando sin dolores de cabeza.

Requisitos previos antes de instalar PrestaShop en Syspanel

Antes de entrar en materia, es importante que verifiques que tu servidor cumple con los requisitos mínimos. Muchas veces, la instalación fallida PrestaShop se debe a que el entorno no está preparado.

Requisitos de PHP y extensiones

PrestaShop 8.x (la versión más reciente) necesita:

PHP 7.2.5 como mínimo, aunque se recomienda PHP 8.0 o superior.
Extensiones obligatorias: curl, gd, intl, mbstring, openssl, pdo_mysql, zip, fileinfo, dom, simplexml.

Requisitos de servidor

MySQL 5.6+ o MariaDB 10.0+.
Espacio en disco suficiente (mínimo 500 MB).
Permisos de escritura en las carpetas de instalación.

Si no estás seguro de qué versión de PHP tienes, en Syspanel puedes cambiarla fácilmente desde la sección de "Dominios" o "Web". Busca la opción de "PHP Version" y selecciona una compatible.

Error 1: Pantalla blanca o error 500 al acceder al instalador

Este es, con diferencia, el error PrestaShop más común. Subes los archivos, intentas acceder a tudominio.com/install y te encuentras con una página en blanco o un error 500.

Causa principal

La causa más habitual es que la versión de PHP no es compatible o que faltan extensiones. A veces, el archivo .htaccess de PrestaShop entra en conflicto con la configuración de Apache.

Solución paso a paso

Cambia la versión de PHP en Syspanel. Ve a la configuración del dominio y prueba con PHP 8.1 o 8.2. Si el error persiste, prueba con PHP 7.4.
Activa la visualización de errores. Temporalmente, puedes añadir estas líneas al archivo config/defines.inc.php:
```
define('_PS_MODE_DEV_', true);
```
Esto mostrará el error exacto en pantalla, lo que te ayudará a diagnosticar el problema.
Revisa los logs del servidor en Syspanel. Ve a "Logs" o "Registros" y busca el error exacto del dominio.
Desactiva el archivo .htaccess temporalmente. Renómbralo a .htaccess.bak y prueba de nuevo. Si funciona, el problema es de reescritura de URLs.

[INFO] Si no ves errores, revisa que la carpeta install tenga permisos 755 y que los archivos no estén corruptos. Vuelve a subirlos si es necesario.

Error 2: "Instalación fallida PrestaShop" por permisos de archivos

Otro clásico. El instalador te dice que no puede escribir en ciertos archivos o carpetas, y el proceso se detiene.

Causa principal

Los permisos de las carpetas no son correctos. PrestaShop necesita escribir en config, cache, log, img, mails, modules, themes, translations, upload, var, app y download.

Solución paso a paso

Conéctate por SSH a tu servidor (o usa el administrador de archivos de Syspanel).

Ejecuta estos comandos en la raíz de PrestaShop:

find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

Da permisos especiales a las carpetas de escritura:

chmod -R 775 config cache log img mails modules themes translations upload var app download

Cambia el propietario si es necesario:
```
chown -R www-data:www-data .
```
(En Syspanel, el usuario suele ser admin o el nombre de tu cuenta, así que ajústalo).

[WARNING] No uses permisos 777. Es un riesgo de seguridad grave. Con 775 es suficiente.

Error 3: Problemas con la base de datos MySQL

El instalador se queja de que no puede conectar a la base de datos, o que el usuario no tiene permisos.

Causa principal

En Syspanel, la creación de bases de datos tiene un formato específico. Si no la creas correctamente, PrestaShop no podrá conectarse.

Solución paso a paso

Crea la base de datos desde Syspanel. Ve a "Base de datos" o "MySQL".
Usa el formato correcto: normalmente, el nombre de la base de datos y el usuario llevan un prefijo con tu nombre de usuario. Por ejemplo, si tu usuario es cliente1, la base se llamará cliente1_prestashop.
Asigna todos los privilegios al usuario sobre esa base de datos.
En el instalador de PrestaShop, usa exactamente esos datos. No inventes nombres.
Verifica que el servidor MySQL es local. Normalmente, el host es localhost, pero en algunos casos es 127.0.0.1 o el nombre del servidor.

[TIP] Si usas MariaDB, el proceso es el mismo. Asegúrate de que el puerto de MySQL es el 3306.

Error 4: "Shop is not installed" o el botón de instalación no aparece

A veces, el instalador no detecta que PrestaShop está listo para instalarse, o te redirige a la tienda en lugar del instalador.

Causa principal

Esto ocurre cuando ya hay una instalación previa (aunque esté incompleta) o cuando el archivo settings.inc.php existe.

Solución paso a paso

Elimina los archivos de instalación previos. Borra la carpeta install y vuelve a subirla desde el paquete original.
Elimina el archivo config/settings.inc.php si existe. Este archivo se crea al finalizar la instalación y, si está presente, PrestaShop cree que ya está instalado.
Limpia la caché del navegador y prueba de nuevo.
Revisa que la URL de acceso sea correcta. Debe ser tudominio.com/install, no tudominio.com.

Error 5: "Fatal error: Allowed memory size exhausted"

Este es un error de memoria PHP muy común. El instalador se queda a medias porque el límite de memoria es demasiado bajo.

Causa principal

El límite de memoria de PHP está configurado a 128M o menos, y PrestaShop necesita más.

Solución paso a paso

Accede a la configuración de PHP en Syspanel. Busca la opción "PHP Options" o "Configuración de PHP".
Aumenta el valor de memory_limit a 512M o incluso 1024M.
Guarda los cambios y reinicia PHP si es necesario (Syspanel suele aplicar los cambios al instante).
Si no puedes cambiarlo desde el panel, crea un archivo php.ini en la raíz de PrestaShop con este contenido:
```
memory_limit = 512M
max_execution_time = 300
```
También puedes editar el archivo .htaccess y añadir:
```
php_value memory_limit 512M
```

[WARNING] Si el problema persiste, contacta con tu proveedor de hosting. Algunos límites están a nivel de servidor y no se pueden sobreescribir.

Error 6: Problemas con la extensión de URL amigables (mod_rewrite)

Después de instalar, las URLs no funcionan o dan error 404.

Causa principal

El módulo mod_rewrite de Apache no está activado, o el archivo .htaccess no se ha generado correctamente.

Solución paso a paso

Activa mod_rewrite en Syspanel. Ve a la configuración de Apache o del dominio y actívalo.
Genera el .htaccess de nuevo. En el panel de administración de PrestaShop, ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Guardar" (esto regenera el archivo).
Verifica que el archivo .htaccess existe en la raíz. Si no, crea uno con el contenido estándar de PrestaShop (puedes copiarlo desde el paquete original).
Comprueba que la opción "URLs amigables" está activada en el panel de administración.

Error 7: "Unable to write in cache" o "El directorio no tiene permisos"

Este error suele aparecer durante la instalación o al intentar acceder al panel de administración.

Causa principal

Las carpetas cache o var/cache no tienen permisos de escritura, o el propietario es incorrecto.

Solución paso a paso

Ejecuta los comandos de permisos que mencionamos en el Error 2.
Elimina el contenido de la carpeta var/cache manualmente. A veces, los archivos corruptos causan problemas.
Revisa que el usuario de PHP (generalmente www-data o nobody) tenga acceso a estas carpetas.
Desde Syspanel, verifica que el "Document Root" del dominio apunta a la carpeta correcta de PrestaShop.

Error 8: Problemas con la instalación de módulos o temas

Después de instalar PrestaShop, no puedes instalar módulos o temas, o se quedan a mitad de instalación.

Causa principal

Faltan extensiones de PHP necesarias para la descarga y descompresión de archivos.

Solución paso a paso

Verifica que las extensiones zip y curl están activadas en la configuración de PHP de Syspanel.
Aumenta el max_execution_time a 300 segundos para evitar que el proceso se corte.
Comprueba que la carpeta modules tiene permisos 775 y que el propietario es el correcto.
Desactiva el "Modo seguro" si está activado en la configuración de PHP.

Error 9: La tienda se ve sin estilos (CSS/JS no cargan)

La tienda carga pero se ve "rota", sin estilos ni imágenes.

Causa principal

Los permisos de las carpetas themes o img son incorrectos, o el servidor no puede leer los archivos estáticos.

Solución paso a paso

Revisa los permisos de las carpetas themes, img y assets. Deben ser 755 para directorios y 644 para archivos.
Regenera las miniaturas. En el panel de administración, ve a "Parámetros avanzados" > "Rendimiento" y activa "Forzar la compilación" temporalmente.
Limpia la caché desde el panel de administración.
Comprueba que el archivo .htaccess no está bloqueando el acceso a archivos CSS/JS.

Error 10: No puedo acceder al panel de administración

Después de la instalación, la URL de administración da error 404 o se queda en un bucle de redirección.

Causa principal

El nombre de la carpeta de administración no coincide con el que se generó durante la instalación, o el archivo .htaccess tiene reglas incorrectas.

Solución paso a paso

Busca la carpeta de administración en la raíz de PrestaShop. Normalmente se llama admin + un código aleatorio (por ejemplo, admin12345).
Renombra la carpeta si es necesario y actualiza la URL.
Elimina el archivo .htaccess de la carpeta de administración si existe.
Revisa el archivo config/settings.inc.php para asegurarte de que la URL base es correcta.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en Syspanel con PHP 8.2?

Sí, PrestaShop 8.x es compatible con PHP 8.2. Sin embargo, algunos módulos de terceros pueden dar problemas. Si tienes errores, prueba con PHP 8.1.

¿Qué hago si el instalador se queda en "Instalando PrestaShop" durante horas?

Esto suele indicar un problema de memoria o de tiempo de ejecución. Aumenta max_execution_time y memory_limit como se explicó en el Error 5. También puedes intentar instalar en modo manual, subiendo los archivos y ejecutando el instalador desde la línea de comandos.

¿Cómo cambio el puerto de acceso a Syspanel?

El acceso a Syspanel se realiza a través del puerto 2106. Por ejemplo, http://tudominio.com:2106. No intentes cambiarlo, es la configuración estándar.

¿Es necesario usar SSL para PrestaShop?

Sí, es altamente recomendable. Puedes instalar un certificado SSL gratuito desde Syspanel (Let's Encrypt) y configurar PrestaShop para forzar HTTPS.

¿Qué hago si después de seguir todos los pasos sigue el error?

Si has probado todas las soluciones y el error persiste, te recomendamos:

Revisar los logs de error en Syspanel.
Contactar con el soporte de tu hosting, indicando el error exacto.
Probar con una versión anterior de PrestaShop (por ejemplo, 1.7.8) si tu servidor es antiguo.

Conclusión: La instalación de PrestaShop en Syspanel es sencilla si conoces los errores comunes

Como has visto, la mayoría de los errores PrestaShop durante la instalación en Syspanel tienen solución. Los problemas más habituales son los permisos, la configuración de PHP y la base de datos. Con esta guía, ya tienes las herramientas para diagnosticar y solucionar cualquier instalación fallida PrestaShop.

Recuerda siempre:

Usa una versión de PHP compatible.
Verifica los permisos de archivos y carpetas.
Crea la base de datos correctamente desde Syspanel.
No uses permisos 777.
Consulta los logs para obtener información detallada.

Con paciencia y siguiendo estos pasos, tu tienda online estará funcionando en menos de lo que piensas. Si te ha resultado útil, comparte esta guía con otros usuarios que estén luchando contra los mismos errores. ¡Buena suerte con tu PrestaShop!