Errores comunes al instalar PrestaShop en Syspanel | Guía

¡Hola! Soy el técnico de soporte de tu Hosting. Si estás leyendo esto, seguramente estés intentando instalar tu tienda PrestaShop en tu panel Syspanel y te hayas encontrado con algún problema. No te preocupes, es más común de lo que crees. He visto cientos de casos como el tuyo, y he preparado esta guía completísima para que puedas solucionar los errores más comunes en la instalación de PrestaShop en Syspanel de una vez por todas.

Vamos a ir paso a paso, desde los errores más tontos (que son los que más duelen) hasta los más técnicos. Al final de este artículo, serás un experto en Syspanel PrestaShop.

1. El Primer Error: No leíste los requisitos de PrestaShop

Antes de instalar nada, PrestaShop es una aplicación que pide unos “mínimos” para funcionar. Si tu Hosting no los cumple, la instalación fallará o la tienda irá muy lenta.

¿Qué versiones de PHP y MySQL necesito?

PrestaShop 8.x (la última versión estable) necesita, como mínimo:

PHP 7.4 (aunque recomiendo PHP 8.0 o 8.1 para mejor rendimiento).
MySQL 5.7 o superior, o MariaDB 10.3 o superior.

[WARNING] Si tienes PHP 7.2 o inferior, la instalación se bloqueará en la pantalla de verificación de requisitos. No sigas adelante sin actualizar.

¿Cómo reviso esto en Syspanel?

Accede a tu Syspanel a través de tudominio.com:2106. (Recuerda, el puerto es el 2106).
Ve a la sección Web y selecciona tu dominio.
Busca la opción Configuración avanzada o PHP Settings.
Ahí podrás cambiar la versión de PHP. Selecciona 8.0 o 8.1.
También verás los límites de memoria (memory_limit). Asegúrate de que sea al menos 256M. Si es menor, cámbialo.

[TIP] Si no ves la opción de cambiar PHP, es posible que tu plan de Hosting no lo permita. Pídenos ayuda por ticket y lo revisamos.

2. Error Clásico: "No se puede crear el archivo settings.inc.php"

Este es el error más frustrante. PrestaShop intenta escribir un archivo de configuración durante la instalación y no tiene permisos para hacerlo.

¿Por qué ocurre?

El servidor web (Apache/Nginx) necesita permisos de escritura en la carpeta donde instalaste PrestaShop.

Solución paso a paso en Syspanel:

Conéctate por FTP a tu hosting. Puedes usar FileZilla o el gestor de archivos del propio Syspanel.
Navega hasta la carpeta public_html (o la carpeta donde hayas subido los archivos de PrestaShop).
Busca el archivo: config/settings.inc.php. Si no existe, no pasa nada, lo crearemos.
Ajusta permisos:
- Haz clic derecho sobre la carpeta config y elige Permisos de archivo.
- Establece 755 para la carpeta.
- Si el archivo settings.inc.php existe, ponle permisos 644.
- Si no existe, crea un archivo vacío llamado settings.inc.php dentro de la carpeta config y dale permisos 644.
Repite el proceso para la carpeta img, upload, download y themes. Todas necesitan permisos 755.

[WARNING] NUNCA pongas permisos 777 a todo. Es un agujero de seguridad. Solo 755 para carpetas y 644 para archivos.

Solución alternativa más sencilla:

En Syspanel, ve a la sección Web -> Dominio -> Gestor de archivos. Busca la carpeta raíz y haz clic en el botón "Corregir permisos" o "Resetear permisos". Esta opción suele dejar todo listo para PrestaShop automáticamente.

3. Error: "La extensión PDO_MySQL no está cargada" o "Falta la extensión MySQLi"

PrestaShop necesita conectarse a la base de datos usando una de estas extensiones de PHP. Si no están activadas, la instalación se detiene.

¿Cómo lo activo en Syspanel?

Ve a Syspanel (puerto 2106).
Entra en Web -> Configuración de PHP.
Busca la lista de Extensiones PHP.
Activa:
- pdo_mysql
- mysqli
- curl
- gd
- mbstring
- openssl
- zip
- intl
Guarda los cambios. El servidor se reiniciará automáticamente.

[INFO] Si no ves la opción de activar extensiones, puede que tu plan de Hosting sea muy básico. Contáctanos y te subimos de plan o lo configuramos manualmente.

4. Error: "La memoria máxima de ejecución es demasiado baja" (max_execution_time)

La instalación de PrestaShop puede tardar un poco, sobre todo si tienes muchos módulos o un tema pesado. Si el tiempo de ejecución es muy bajo, el proceso se corta.

Solución:

En la misma sección de Configuración de PHP de Syspanel, busca el parámetro max_execution_time.
Auméntalo a 300 (segundos). Así le das 5 minutos para que termine la instalación.
También busca memory_limit y ponlo a 256M o 512M.

5. Error: "No se puede conectar a la base de datos"

Este error aparece cuando los datos de la base de datos que pusiste en el instalador son incorrectos.

¿Cómo creo la base de datos correctamente en Syspanel?

En Syspanel, ve a Bases de datos -> Añadir base de datos.
Nombre de la BD: Elige uno (ej. tienda_presta).
Usuario: Crea un usuario (ej. admin_tienda).
Contraseña: Usa una segura. Guárdala bien.
Asociar usuario a la BD: Marca la base de datos que acabas de crear y asígnale el usuario.
Importante: En el instalador de PrestaShop, cuando te pida:
- Servidor de base de datos: Pon localhost (a menos que tu Syspanel te dé otro, pero casi siempre es localhost).
- Usuario: El que creaste (admin_tienda).
- Contraseña: La que pusiste.
- Nombre de la BD: El que creaste (tienda_presta).

[TIP] Si usas un servidor de bases de datos remoto, te aparecerá en los detalles del Syspanel. Cópialo exactamente.

6. Error: "El nombre de dominio no está apuntando al servidor" o "No se puede acceder a la tienda"

A veces instalas bien, pero al poner el dominio te sale un error 404 o de conexión.

Causas y soluciones:

DNS no propagados: Si acabas de registrar el dominio, espera entre 24 y 48 horas.
No has creado el dominio en Syspanel: Debes añadir tu dominio en Web -> Añadir dominio.
La carpeta raíz no es la correcta: En la configuración del dominio en Syspanel, asegúrate de que apunta a la carpeta donde instalaste PrestaShop (normalmente public_html o una subcarpeta como tienda).
El .htaccess no se ha generado: PrestaShop crea un archivo .htaccess para las URL amigables. Si no se generó, ve a tu FTP, renombra el archivo htaccess.txt a .htaccess (con punto delante) y luego desde el backoffice de PrestaShop ve a Configuración -> Tráfico y SEO -> URLs amigables y actívalas de nuevo.

7. Error de "Tiempo de espera agotado" (Timeout) en la instalación

Especialmente si tu hosting es compartido o tienes muchos recursos limitados, la instalación puede colgarse.

Soluciones rápidas:

Aumenta el max_execution_time como vimos antes (a 300 o 600).
Usa la instalación en modo CLI (si tienes acceso SSH). Es más rápida y no tiene límite de tiempo. Si no, pídenos ayuda.
Instala una versión más ligera: Si tu hosting es muy básico, prueba con PrestaShop 1.7 (aunque no es recomendable por seguridad, a veces es la única opción).

8. Problemas con los Módulos y Temas después de la instalación

Una vez instalado, a veces los módulos no se activan o dan error.

Causa frecuente: Falta de permisos en carpetas específicas

Carpetas problemáticas: modules, themes, var/cache, config, img.
Solución: Vuelve a dar permisos 755 a estas carpetas desde el FTP o gestor de archivos de Syspanel.
Limpia la caché: En el backoffice de PrestaShop, ve a Configuración avanzada -> Rendimiento -> Limpiar caché.

FAQ: Preguntas Frecuentes que resuelven dudas comunes

¿Puedo instalar PrestaShop en un subdominio?

Sí, perfectamente. Solo crea el subdominio en Syspanel (ej. tienda.tudominio.com) y apunta la carpeta raíz a la subcarpeta donde subas los archivos.

¿Qué hago si veo un error 500 después de instalar?

Revisa el archivo .htaccess: A veces está corrupto. Renómbralo a .htaccess.bak y prueba de nuevo.
Aumenta la memoria de PHP: A 256M o más.
Activa el modo debug: En el archivo config/defines.inc.php, cambia define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);. Esto te mostrará el error exacto.

Mi Syspanel no me deja cambiar la versión de PHP. ¿Qué hago?

Es posible que tu plan de Hosting sea de gama baja. Syspanel (HestiaCP) permite la gestión de versiones, pero a veces el administrador del servidor lo restringe. Abre un ticket de soporte y te lo cambiamos nosotros o te ofrecemos un plan mejor.

¿Es necesario usar SSL (HTTPS) para PrestaShop?

Sí, totalmente. Google penaliza las tiendas sin HTTPS y los navegadores las marcan como "No seguras". Syspanel suele incluir Let's Encrypt gratis. Actívalo en Web -> SSL -> Añadir certificado SSL -> Let's Encrypt.

¿Cómo hago una copia de seguridad antes de instalar?

En Syspanel, ve a Copia de seguridad. Puedes hacer un backup completo de tu web y base de datos con un solo clic. Hazlo siempre antes de cualquier instalación o actualización.

Conclusión: No te rindas, la solución está aquí

Instalar PrestaShop en Syspanel no es cosa de otro mundo, pero tiene sus mañas. La mayoría de los errores se solucionan con tres pasos mágicos:

PHP correcto (versión y extensiones).
Permisos adecuados (755/644).
Base de datos bien configurada.

Si después de seguir esta guía sigues teniendo problemas, no dudes en contactarnos. Somos tu equipo de soporte y estamos aquí para ayudarte. Abre un ticket desde tu Syspanel o escríbenos directamente.

[INFO] Recuerda que nuestro panel de control es Syspanel (basado en HestiaCP) y el acceso es por el puerto 2106. No lo olvides.

¡Ánimo! Tu tienda online está a un paso de arrancar.