Errores comunes al instalar PrestaShop en Syspanel: Soluciones

¿Te has decidido a instalar PrestaShop en tu servidor y te has encontrado con pantallazos de error, carpetas que no se crean o una tienda que simplemente no arranca? No te preocupes, es más común de lo que crees. La instalación de PrestaShop, una de las plataformas de ecommerce más potentes, puede presentar ciertos escollos técnicos, sobre todo si no estás familiarizado con la configuración del servidor. Aquí es donde entra Syspanel, tu aliado para gestionar el hosting de forma visual y sencilla.

En esta guía extensa, vamos a desglosar los errores más habituales que surgen al montar PrestaShop y, lo más importante, cómo solucionarlos paso a paso utilizando Syspanel. Olvídate de líneas de comando complejas; aquí todo se hace desde un panel limpio y amigable.

Errores de permisos de archivos y carpetas

Uno de los fallos más repetidos al instalar PrestaShop es el temido mensaje: "No se puede escribir en la carpeta /cache" o "Error al crear el archivo de configuración". Esto suele deberse a que el usuario del servidor web (por ejemplo, www-data) no tiene permisos suficientes sobre los archivos de tu tienda.

¿Por qué ocurre esto?

Cuando subes los archivos de PrestaShop por FTP o a través del gestor de archivos de Syspanel, los archivos se asignan a tu usuario de hosting. Sin embargo, PHP se ejecuta bajo un usuario diferente (el del servidor web). Si los permisos no son los correctos, PHP no puede escribir en carpetas como cache, log o config.

Solución con Syspanel

Syspanel incluye una herramienta de permisos muy potente. Sigue estos pasos:

Accede a Syspanel a través del puerto 2106 (ejemplo: tudominio.com:2106).
Ve a la sección "Archivos" o "Gestor de archivos".
Navega hasta la raíz de tu instalación de PrestaShop.
Busca la opción "Permisos" o "Cambiar propietario" (a veces está en un menú contextual al hacer clic derecho sobre la carpeta principal).
Selecciona la carpeta raíz de tu tienda (por ejemplo, /public_html o /tienda).
Marca la casilla "Aplicar recursivamente a subcarpetas y archivos".
Establece el propietario como el usuario del servidor web (normalmente www-data o nobody). Syspanel suele mostrarlo en una lista desplegable.
Para los permisos numéricos, establece 755 para directorios y 644 para archivos. Algunas versiones de Syspanel tienen un botón "PrestaShop" que aplica automáticamente los permisos recomendados.

[TIP] Si después de esto sigues teniendo problemas, revisa que la carpeta /config y el archivo settings.inc.php tengan permisos 644 (no 777 por seguridad). PrestaShop solo necesita escritura temporal durante la instalación.

Problemas con la versión de PHP

PrestaShop es exigente con la versión de PHP. Si tu servidor ejecuta una versión antigua (PHP 5.x) o demasiado moderna (PHP 8.2+ sin compatibilidad), la instalación se detendrá con un error de requisitos.

Síntomas típicos

Pantalla en blanco o error 500.
Mensaje: "La versión de PHP no es compatible".
El instalador no pasa del primer paso.

Cómo solucionarlo desde Syspanel

Syspanel te permite cambiar la versión de PHP para cada dominio o subdominio de forma independiente. Así se hace:

En el panel principal de Syspanel, ve a "Web" o "Dominios".
Busca el dominio donde estás instalando PrestaShop (por ejemplo, tutienda.com).
Haz clic en el icono de "Editar" (normalmente un lápiz o engranaje).
Busca la sección "Versión de PHP" o "PHP Settings".
Selecciona una versión entre 7.4 y 8.1. La versión 8.0 suele ser la más equilibrada para PrestaShop 8.x.
Guarda los cambios. Syspanel actualizará la configuración del servidor web automáticamente.

[WARNING] Si tu PrestaShop es antiguo (versión 1.6 o inferior), usa PHP 7.4. Las versiones 8.x rompen muchos módulos antiguos.

Errores de la base de datos MySQL/MariaDB

Otro punto crítico es la base de datos. Los errores típicos incluyen "No se puede conectar al servidor MySQL", "Usuario sin privilegios" o "Error al crear las tablas".

Causas comunes

El nombre de la base de datos, usuario o contraseña son incorrectos.
El usuario de la base de datos no tiene permisos sobre la base de datos.
El servidor MySQL no acepta conexiones desde el localhost.

Creación correcta desde Syspanel

Syspanel simplifica la gestión de bases de datos. Para evitar errores, sigue esta receta:

En Syspanel, ve a la sección "Bases de datos".
Haz clic en "Añadir base de datos".
Introduce un nombre (por ejemplo, prestashop_db). El sistema añadirá automáticamente un prefijo con tu usuario.
Crea un usuario y una contraseña segura. Syspanel puede generarla automáticamente.
Marca la casilla "Otorgar todos los privilegios" o selecciona explícitamente ALL PRIVILEGES.
Haz clic en "Guardar".
Durante la instalación de PrestaShop, usa exactamente los datos que te proporciona Syspanel: el nombre completo de la base de datos (con el prefijo), el usuario completo y la contraseña. El servidor suele ser localhost.

[INFO] Si tu PrestaShop se queja de que la base de datos existe pero está vacía, asegúrate de que el usuario tenga privilegios CREATE y DROP. A veces, por seguridad, se limitan estos permisos.

Errores de extensiones PHP faltantes

PrestaShop necesita ciertas extensiones de PHP para funcionar: mysqli, gd, curl, zip, openssl, mbstring, etc. Si alguna falta, el instalador te mostrará una lista en rojo.

Solución en Syspanel

Aunque Syspanel no te permite instalar extensiones PHP directamente desde la interfaz (eso se hace a nivel de servidor), sí puedes verificar el estado y, en muchos casos, activarlas desde la configuración del dominio.

Ve a "Dominios" > "Editar" (tu dominio).
Busca la sección "Extensiones PHP" o "PHP Modules".
Verás una lista de extensiones con casillas de verificación. Asegúrate de que estén marcadas: mysqli, gd, curl, zip, mbstring, openssl, xml, json y fileinfo.
Guarda los cambios y reinicia el servicio web desde la sección "Servicios" > "Reiniciar Nginx/Apache" (dependiendo de tu configuración).

Si alguna extensión no aparece en la lista, deberás contactar al soporte de tu hosting o, si tienes acceso root, instalarla mediante comandos (por ejemplo, apt install php8.0-gd). Syspanel te facilita la vida, pero las extensiones base dependen del sistema operativo.

[TIP] Si usas Syspanel con un servidor dedicado, puedes instalar extensiones desde el panel de administración avanzada (si está disponible) o solicitarlo al administrador.

Error de URL de la tienda o redirecciones incorrectas

Después de instalar, a veces la tienda no carga bien porque la URL base está mal configurada o hay redirecciones infinitas.

Cómo arreglarlo desde Syspanel

Ve a "Web" > "Dominios".
Edita tu dominio y busca la sección "Redirecciones" o "SSL".
Asegúrate de que no haya redirecciones forzadas que interfieran (por ejemplo, de HTTP a HTTPS si aún no has instalado el certificado).
Si usas HTTPS, desde Syspanel puedes instalar un certificado SSL gratuito (Let's Encrypt) en un solo clic en la sección "SSL".
Después de instalar el SSL, ve a "Configuración del dominio" y marca "Forzar HTTPS".

[WARNING] No actives el forzado de HTTPS hasta que hayas instalado correctamente el certificado SSL, o tu tienda quedará inaccesible.

FAQ: Preguntas frecuentes sobre instalación de PrestaShop y Syspanel

¿Puedo instalar PrestaShop automáticamente con Syspanel?

Sí. Muchas versiones de Syspanel incluyen un instalador de aplicaciones (Softaculous o similar). Busca la sección "Aplicaciones" o "Instalador" y selecciona PrestaShop. El panel se encargará de crear la base de datos, subir los archivos y configurar los permisos por ti.

¿Qué hago si el instalador de PrestaShop se queda en blanco?

Esto suele ser por falta de memoria PHP. En Syspanel, ve a "Dominios" > "Editar" > "PHP Settings" y aumenta el valor de memory_limit a 256M o 512M. También sube max_execution_time a 300.

¿Cómo subo los archivos de PrestaShop a mi servidor?

Usa el Gestor de archivos de Syspanel o un cliente FTP. Sube todos los archivos a la carpeta raíz de tu dominio (normalmente public_html). Luego, aplica los permisos como explicamos al principio.

¿Por qué Syspanel me pide el puerto 2106?

Syspanel (basado en HestiaCP) utiliza el puerto 2106 para el panel de control web. Es la puerta de entrada para gestionar todo tu hosting. Asegúrate de que ese puerto esté abierto en tu firewall.

¿Puedo tener varias tiendas PrestaShop en un mismo servidor con Syspanel?

Sí. Crea un subdominio o un dominio adicional desde Syspanel y repite el proceso de instalación. Cada tienda será independiente.

¿Cómo hago una copia de seguridad de mi PrestaShop desde Syspanel?

Ve a "Backups" en Syspanel. Puedes programar copias automáticas diarias o semanales. También puedes hacer una copia manual de la carpeta y la base de datos.

Conclusión

Instalar PrestaShop no tiene por qué ser una pesadilla técnica. Con Syspanel, la mayoría de los errores comunes tienen una solución visual, rápida y al alcance de un clic. Desde los permisos de archivos hasta la configuración de PHP y las bases de datos, este panel de control te permite mantener el foco en lo que importa: montar tu tienda online.

Recuerda siempre verificar los requisitos de PrestaShop antes de empezar, usar las herramientas de Syspanel para gestionar permisos y bases de datos, y no dudes en reiniciar los servicios si algo no funciona. Si sigues estos pasos, tu tienda estará online en pocos minutos.

¿Te ha quedado alguna duda? Revisa la sección de FAQ o consulta la documentación de Syspanel. ¡Buena suerte con tu ecommerce!