Problemas al instalar PrestaShop en Syspanel: soluciones rápidas

Instalar PrestaShop en Syspanel es un proceso sencillo si sigues los pasos correctos, pero a veces pueden surgir errores inesperados. No te preocupes, aquí te guiaré paso a paso para que puedas solucionar los problemas más comunes al instalar PrestaShop Syspanel. Al final, tendrás tu tienda online funcionando sin dolores de cabeza.

¿Por qué aparecen errores al instalar PrestaShop en Syspanel?

Antes de meternos en las soluciones concretas, es útil entender por qué ocurren estos fallos. Syspanel (antes conocido como HestiaCP, accesible por el puerto 2106) es un panel de control potente, pero PrestaShop tiene requisitos específicos. Los errores más frecuentes suelen deberse a:

Versión de PHP incorrecta o faltante: PrestaShop necesita PHP 7.4, 8.0 o 8.1 (dependiendo de la versión). Si tienes PHP 8.2 o superior, pueden aparecer incompatibilidades.
Permisos de archivos y carpetas mal configurados: El servidor web necesita poder leer y escribir en ciertos directorios para instalar y actualizar la tienda.
Falta de extensiones de PHP necesarias: PrestaShop requiere extensiones como mysqli, gd, curl, zip, mbstring, openssl, pdo_mysql, intl, bcmath, json, xml, fileinfo, dom, y imagick (recomendado).
Base de datos mal creada o con privilegios insuficientes: El usuario de la base de datos debe tener todos los permisos sobre la base de datos asignada.
Errores de configuración del servidor web (Nginx/Apache): A veces las reglas de reescritura de URL no están activadas o hay un conflicto con el archivo .htaccess.
Versión de PrestaShop incompatible con el servidor: No todas las versiones funcionan igual en todos los entornos.

Vamos a ver cómo solucionar cada uno de estos puntos.

Solución paso a paso a errores comunes al instalar PrestaShop en Syspanel

1. Verificar y actualizar la versión de PHP en Syspanel

Este es el error más común. Si ves un mensaje como “PHP no es compatible” o “Se requiere PHP 7.4+”, debes cambiar la versión de PHP para tu dominio.

Pasos para cambiar la versión de PHP:

Accede a tu panel Syspanel (puerto 2106, ejemplo: https://tudominio.com:2106).
Ve a la sección Web > Dominios.
Busca tu dominio donde quieres instalar PrestaShop y haz clic en Editar (icono de lápiz).
Dentro de la configuración, busca el campo Versión de PHP.
Selecciona una versión compatible: PHP 8.0 o PHP 8.1 son las más recomendadas para PrestaShop 8.x. Si usas una versión antigua de PrestaShop (1.7), puedes usar PHP 7.4.
Guarda los cambios.

[TIP] Si no ves la opción de cambiar PHP, es posible que tu plan de hosting no lo permita. Contacta con tu proveedor.

2. Solucionar errores de permisos de archivos y carpetas

Si durante la instalación ves errores como “No se puede escribir en la carpeta /img” o “Permiso denegado”, es un problema de permisos.

Cómo corregirlo desde Syspanel:

Ve a Web > Dominios > haz clic en Abrir explorador de archivos (icono de carpeta) junto a tu dominio.
Navega hasta la carpeta donde has subido PrestaShop (normalmente public_html o una subcarpeta).
Selecciona todos los archivos y carpetas (puedes usar Ctrl+A).
Busca la opción Permisos o CHMOD en el menú superior.
Establece los permisos de la siguiente manera:
- Carpetas: 755
- Archivos: 644
También asegúrate de que el propietario de los archivos sea el usuario de Syspanel (normalmente admin o tu nombre de usuario). Si no, usa la opción Propietario para cambiarlo.

[WARNING] No uses permisos 777 a menos que sea estrictamente necesario y solo temporalmente. Es un riesgo de seguridad.

3. Activar las extensiones de PHP necesarias

PrestaShop te mostrará un listado de extensiones faltantes durante la instalación. Para activarlas:

Ve a Servidor > Configuración > PHP (o Extensiones PHP).
Busca las extensiones mencionadas: curl, gd, mysqli, zip, mbstring, openssl, pdo_mysql, intl, bcmath, json, xml, fileinfo, dom.
Marca las que estén desactivadas (sin tilde) y actívalas.
Guarda los cambios. Es posible que el servidor se reinicie automáticamente.

[INFO] Si no encuentras estas opciones, contacta a tu proveedor de hosting para que te las active desde el servidor.

4. Crear y configurar correctamente la base de datos

Un error típico es “No se puede conectar a la base de datos” o “Usuario sin privilegios”. Para evitarlo:

Pasos para crear la base de datos en Syspanel:

Ve a Base de datos > Añadir base de datos.
Completa los campos:
- Nombre de la base de datos: Por ejemplo, prestashop_db.
- Usuario: Por ejemplo, prestashop_user.
- Contraseña: Usa una contraseña segura (puedes generarla con el botón de generar).
Haz clic en Añadir.
Durante la instalación de PrestaShop, usa estos datos exactos.

[TIP] Anota los datos de la base de datos en un lugar seguro. Los necesitarás también para futuras actualizaciones.

5. Solucionar errores de servidor web (Nginx/Apache)

Si al acceder a tu dominio ves un error 500 o 404, puede ser por reglas de reescritura o el archivo .htaccess.

Para Nginx (más común en Syspanel):

Ve a Web > Dominios > haz clic en Editar en tu dominio.
Busca la sección Configuración de Nginx.
Asegúrate de que Proxy esté desactivado (a menos que uses un proxy inverso).
En Reglas de reescritura, selecciona PrestaShop (si aparece) o añade las reglas manualmente. Si no, puedes pegar las reglas básicas de PrestaShop para Nginx (puedes buscarlas en la documentación oficial).
Guarda los cambios y reinicia el servidor web desde Servidor > Reiniciar > Nginx.

Para Apache (si lo usas):

Asegúrate de que el módulo mod_rewrite esté activado (pregunta a tu proveedor).
El archivo .htaccess debe existir en la raíz de PrestaShop. Si no está, puedes copiar el archivo htaccess.txt que viene en el paquete de instalación y renombrarlo a .htaccess.

6. Errores de versión de PrestaShop incompatible

Si instalas una versión muy reciente (por ejemplo, PrestaShop 8.2) y tu servidor tiene PHP 7.4, dará error. La solución es:

Actualiza PHP (como vimos en el punto 1).
O descarga una versión de PrestaShop compatible con tu PHP actual. Por ejemplo, PrestaShop 1.7 funciona con PHP 7.4.

FAQ: Preguntas frecuentes sobre Syspanel PrestaShop error

¿Qué hago si veo “500 Internal Server Error” al instalar?

Este error suele deberse a un archivo .htaccess corrupto o a permisos incorrectos. Prueba a renombrar el .htaccess a .htaccess_old y vuelve a intentar la instalación. También verifica los permisos de las carpetas (755) y archivos (644).

¿Cómo sé si mi Syspanel tiene las extensiones de PHP necesarias?

Puedes crear un archivo llamado info.php en la raíz de tu dominio con el siguiente contenido: <?php phpinfo(); ?>. Luego accede a tudominio.com/info.php y busca las extensiones. Borra este archivo después por seguridad.

¿Qué significa “Syspanel PrestaShop error de conexión a base de datos”?

Significa que los datos de la base de datos son incorrectos o que el usuario no tiene permisos. Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en Syspanel. También verifica que el servidor de base de datos sea localhost (o 127.0.0.1).

¿Puedo instalar PrestaShop en una subcarpeta de mi dominio?

Sí. Solo asegúrate de que la carpeta tenga los permisos correctos y que la URL de instalación apunte a esa subcarpeta. Por ejemplo, tudominio.com/tienda.

¿Cómo reinicio el servidor web después de cambios?

En Syspanel, ve a Servidor > Reiniciar > selecciona Nginx (y Apache si lo usas) y haz clic en Reiniciar. También puedes reiniciar desde la terminal si tienes acceso SSH.

Consejos finales para una instalación exitosa

Descarga PrestaShop desde la web oficial (prestashop.com) para evitar versiones modificadas.
Descomprime el archivo ZIP en tu ordenador y luego súbelo a Syspanel mediante el explorador de archivos o FTP. Es más fiable que descomprimir en el servidor.
Usa un subdominio para pruebas (por ejemplo, test.tudominio.com) antes de instalar en el dominio principal.
Si el error persiste, revisa los logs de error de Syspanel. Ve a Servidor > Logs y busca errores recientes. Suelen dar pistas claras.

[WARNING] No olvides borrar el archivo info.php si lo creaste, y eliminar la carpeta install de PrestaShop una vez terminada la instalación (por seguridad).

Con estos pasos, la mayoría de los problemas al instalar PrestaShop Syspanel se resuelven rápidamente. Recuerda que la paciencia y seguir el orden de las soluciones es clave. Si aún así tienes dudas, tu proveedor de hosting puede ayudarte con configuraciones más avanzadas del servidor. ¡Buena suerte con tu tienda online!