Errores al instalar PrestaShop en Plesk | Soluciones prácticas

¡Hola! Soy tu técnico de soporte de confianza. Si estás aquí, seguramente estás intentando montar tu tienda online con PrestaShop en un servidor que usa Plesk y te has topado con algún que otro problema. No te preocupes, es más común de lo que crees. He visto cientos de casos similares, y casi siempre la solución es sencilla si sabes dónde mirar.

En esta guía extensa y muy práctica, vamos a desglosar los errores de instalación más frecuentes, paso a paso, y te daré la solución Prestashop que necesitas para que tu proyecto salga adelante sin dolores de cabeza. Vamos a ello.

Errores comunes antes de empezar la instalación

Antes de subir los archivos, el propio Plesk o la configuración del servidor pueden darnos algún que otro susto. Aquí tienes los más habituales.

Error: "No se puede conectar a la base de datos" o "Error de conexión MySQL"

Este es, sin duda, el clásico. Aparece cuando PrestaShop intenta conectar con la base de datos que has creado en Plesk, pero algo falla.

Causas principales:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos están mal escritos.
Usuario no asignado a la base de datos: En Plesk, debes añadir explícitamente el usuario a la base de datos.
Host de la base de datos incorrecto: A veces, el "localhost" no funciona y hay que usar la IP del servidor o el nombre del contenedor de MySQL.

Solución paso a paso:

Verifica en Plesk: Ve a "Bases de datos" y localiza la que creaste para tu PrestaShop.
Comprueba el usuario: Asegúrate de que el usuario que usarás está añadido a esa base de datos. Si no, añádelo desde el botón "Añadir usuario".
Copia exacta: Durante la instalación de PrestaShop, en el paso de la base de datos, copia exactamente el nombre de la base de datos, el usuario y la contraseña que ves en Plesk.
El host mágico: Si te pide el "Servidor de base de datos", prueba primero con localhost. Si no funciona, usa la dirección IP de tu servidor (la que ves en Plesk). En algunos casos, especialmente con Plesk y Docker, puede ser 127.0.0.1 o el nombre de un contenedor como mysql.

[TIP] Si tienes dudas, mira en Plesk la sección "Bases de datos". Verás una línea como "Acceso a la base de datos: localhost". Ese es el valor que debes usar.

Error: "Extensiones PHP necesarias" o "Requisitos del sistema no cumplidos"

PrestaShop es exigente con las extensiones de PHP que debe tener activadas. Plesk te permite gestionarlas fácilmente.

Causas principales:

Falta de extensiones clave: Como mysqli, pdo_mysql, gd, curl, openssl, mbstring, zip, intl, xsl y json.
Versión de PHP incorrecta: PrestaShop necesita PHP 7.4 o superior (recomendado 8.0, 8.1 o 8.2).

Solución paso a paso:

Accede a la configuración de PHP: En Plesk, ve a tu dominio, luego a "Configuración de PHP" (o PHP Settings).
Selecciona la versión: Elige una versión moderna de PHP (8.1 es muy estable para PrestaShop).
Habilita las extensiones: Busca en la lista las extensiones que te falten y actívalas. Normalmente están en un apartado de "Extensiones" o "Módulos". Marca todas las mencionadas arriba.
Guarda los cambios: Pulsa en "Aceptar" o "Guardar". Plesk reiniciará PHP automáticamente.

[WARNING] No actives extensiones sin saber lo que haces, pero las que te he listado son 100% necesarias para PrestaShop. Si ves alguna que no conoces, déjala como está.

Errores durante la instalación web (el asistente)

Una vez que los requisitos del servidor están bien, lanzamos el instalador web de PrestaShop (/install). Aquí suelen aparecer los problemas más frustrantes.

Error: "El directorio no tiene permisos de escritura" o "Permisos incorrectos"

PrestaShop necesita poder escribir en ciertas carpetas (como config, cache, img, log, themes, upload, download, sitemap.xml).

Causas principales:

Propietario del archivo incorrecto: Los archivos deben ser propiedad del usuario del sistema (generalmente el que ejecuta PHP, como www-data o el usuario del plan de hosting).
Permisos 755 o 777: A veces los permisos son demasiado restrictivos.

Solución paso a paso:

Conéctate por FTP o al administrador de archivos de Plesk.
Selecciona la carpeta raíz donde instalaste PrestaShop (por ejemplo, httpdocs).
Ajusta los permisos: La mayoría de los archivos deben estar en 644 y las carpetas en 755. Algunas carpetas concretas (las que menciona el error) pueden necesitar 777 temporalmente.
- En Plesk: Ve a "Administrador de archivos", selecciona la carpeta, haz clic derecho y elige "Permisos". Pon 755 para carpetas y 644 para archivos.
- Si el error persiste, prueba con 777 solo en las carpetas problemáticas (config, cache, img, etc.) y luego, tras la instalación, vuelve a poner 755.
Propietario: Si usas Plesk, normalmente el usuario del plan de hosting ya es el propietario. Si no, desde SSH (si tienes acceso) ejecuta: chown -R usuario:psacln /ruta/a/prestashop. Esto es más avanzado, pero si tu hosting lo permite, es la solución definitiva.

[INFO] En la mayoría de los alojamientos compartidos con Plesk, los permisos ya vienen correctos. Si tienes problemas, contacta con tu proveedor de hosting.

Error: "No se puede crear el archivo settings.inc.php"

Este archivo guarda la configuración de la base de datos. Si no se puede crear, la instalación se queda bloqueada.

Causas principales:

Permisos en la carpeta config: La carpeta config no tiene permisos de escritura.
Archivo ya existe y está bloqueado: Si ya hiciste un intento fallido, el archivo puede estar ahí pero con datos incorrectos.

Solución paso a paso:

Borra el archivo settings.inc.php de la carpeta config (si existe).
Asegúrate de que la carpeta config tenga permisos 755 o 777.
Vuelve a ejecutar el instalador desde el principio. A veces, simplemente borrar ese archivo y refrescar la página soluciona el problema.

Error: "El tiempo de ejecución ha sido superado" o "500 Internal Server Error"

Esto suele ocurrir en servidores con recursos limitados o con un max_execution_time muy bajo.

Causas principales:

PHP con límite de tiempo bajo: El instalador necesita tiempo para descomprimir archivos y crear tablas.
Memoria insuficiente: El límite de memoria de PHP es demasiado bajo.

Solución paso a paso:

Aumenta el tiempo de ejecución: En la configuración de PHP de Plesk, busca max_execution_time y ponlo a 300 (5 minutos) o incluso 600.
Aumenta la memoria: Busca memory_limit y ponlo a 256M o 512M.
Guarda los cambios y reintenta la instalación.

[TIP] Si el error persiste, puede que tu plan de hosting sea muy limitado. Considera cambiar a un plan con más recursos o un VPS.

Errores después de la instalación (la tienda no funciona bien)

¡La instalación terminó! Pero al entrar a la tienda, todo está roto o sale un error blanco.

Error: "Página en blanco" o "Error 500" al acceder al front office o back office

Es el error más temido. Puede ser por mil cosas, pero la más común es un problema con los módulos o el tema.

Causas principales:

Modo debug desactivado: No ves el error real, solo una pantalla en blanco.
Módulo o tema incompatible: Se activó algo que no funciona con tu versión de PHP o PrestaShop.
Problema de caché: La caché de PrestaShop o de Plesk está corrupta.

Solución paso a paso:

Activa el modo debug: Edita el archivo /config/defines.inc.php. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda el archivo. Ahora verás el error real en la pantalla.
Identifica el error: Normalmente te dirá algo como "Class 'X' not found in /ruta/al/archivo.php". Eso te indica qué módulo o tema está fallando.
Desactiva el módulo/tema problemático: Si puedes acceder al back office, desactívalo. Si no, hazlo desde la base de datos (tabla ps_module o ps_theme).
Limpia la caché: Borra las carpetas /cache/smarty/compile/ y /cache/smarty/cache/ (no borres las carpetas, solo su contenido).
Vuelve a poner el modo debug en false una vez solucionado.

Error: "El carrito no funciona" o "Problemas con AJAX"

Esto suele deberse a una mala configuración de la URL o de la redirección.

Causas principales:

URL canónica incorrecta: En la configuración de la tienda, la URL no coincide con la real.
Redirección a www o no www mal configurada.
Problemas con el SSL (HTTPS): Si tienes certificado, la tienda debe funcionar siempre por HTTPS.

Solución paso a paso:

Ve al back office: Parámetros de la tienda > Tráfico y SEO > Configuración de SEO y URLs.
Verifica la URL base: Debe ser exactamente la de tu dominio (ej: https://tutienda.com).
Configura la redirección: Elige si quieres usar www o no, y activa la opción "Redirigir a la URL canónica".
Fuerza SSL: En la misma sección, activa "Forzar SSL en todas las páginas".
Limpia la caché de Smarty (como en el paso anterior) y prueba de nuevo.

Preguntas Frecuentes (FAQ)

¿Puedo instalar PrestaShop en un subdominio con Plesk?

Sí, perfectamente. El proceso es el mismo. Solo asegúrate de que el subdominio tenga su propia carpeta y que los permisos y la configuración de PHP sean correctos.

¿Qué hago si no tengo acceso a SSH?

No te preocupes. Casi todo se puede hacer desde el panel de Plesk: administrador de archivos, bases de datos, configuración de PHP, etc. Para los permisos, usa el administrador de archivos de Plesk.

¿Y si uso otro panel como Syspanel (HestiaCP)?

Si usas Syspanel (el antiguo HestiaCP), el proceso es muy similar. La principal diferencia es que el acceso al panel es a través del puerto 2106 (ej: https://tudominio.com:2106). Los conceptos de bases de datos, permisos y PHP son los mismos. Esta guía también te servirá, solo adapta la interfaz.

¿Por qué mi instalación se queda en "Creando tablas" durante horas?

Es un síntoma de que el servidor tiene poca memoria o el tiempo de ejecución es muy bajo. Aumenta max_execution_time y memory_limit como te expliqué antes. Si sigue, contacta con tu hosting.

¿Debo usar la última versión de PrestaShop siempre?

No necesariamente. La última versión puede tener requisitos de PHP muy altos (8.2 o 8.3). Revisa los requisitos del sistema de la versión que quieras instalar. Para Plesk, las versiones 1.7.8.x y 8.0.x son muy estables.

Conclusión

Instalar PrestaShop en Plesk no tiene por qué ser una pesadilla. Como has visto, la mayoría de los errores de instalación se deben a tres cosas: permisos, configuración de PHP o problemas con la base de datos. Con esta guía, tienes las herramientas para resolver el 90% de los casos.

Recuerda siempre:

Verifica los requisitos de PHP antes de empezar.
Copia exactamente las credenciales de la base de datos desde Plesk.
Ajusta los permisos de las carpetas si es necesario.
Activa el modo debug para ver errores reales.

Si después de seguir todos estos pasos sigues atascado, no dudes en contactar con tu proveedor de hosting. A veces, el problema está en la configuración general del servidor y ellos pueden ayudarte.

¡Espero que tu tienda online esté funcionando en un abrir y cerrar de ojos! Si te ha sido útil, comparte esta guía con otros que estén en las mismas. ¡Buena suerte!