Errores comunes al instalar PrestaShop en Plesk y cómo solucionarlos

Antes de empezar: ¿Por qué PrestaShop no instala en Plesk?

Si estás leyendo esto, probablemente ya intentaste instalar PrestaShop en Plesk y te encontraste con una pantalla de error, un proceso que se queda a medias o un mensaje críptico que no entiendes. No te preocupes, es mucho más común de lo que parece.

La gran mayoría de los problemas al instalar PrestaShop en Plesk no tienen que ver con el panel en sí, sino con tres factores concretos: la versión de PHP, los permisos de archivos y la configuración de la base de datos. Vamos a desglosar cada uno de ellos paso a paso, con soluciones prácticas que puedes aplicar aunque no seas un experto en servidores.

Requisitos PHP PrestaShop: La causa número uno de fallos

PrestaShop es un software exigente. Si tu servidor no cumple con los requisitos PHP PrestaShop, la instalación se detendrá en seco, generalmente mostrando un mensaje como "Requisitos no cumplidos" o una página en blanco.

¿Qué versión de PHP necesitas?

Para PrestaShop 8.x (la versión más reciente y estable), necesitas PHP 7.2.5 o superior, aunque se recomienda PHP 8.0 o 8.1 para un rendimiento óptimo. Para PrestaShop 1.7.x, necesitas PHP 5.6 o superior, pero mejor si usas PHP 7.x.

Cómo cambiar la versión de PHP en Plesk

Plesk hace que esto sea muy sencillo:

Entra a tu panel de Plesk y selecciona el dominio donde quieres instalar PrestaShop.
Busca la sección "PHP Settings" o "Configuración de PHP" en el menú del dominio.
En el desplegable "PHP version", selecciona la versión que necesitas (por ejemplo, PHP 8.1).
Haz clic en "Apply" o "Aplicar" para guardar los cambios.

[TIP] Si no ves la opción de cambiar la versión de PHP, es posible que tu plan de hosting no lo permita. Contacta con tu proveedor y pídeles que activen el selector de versiones de PHP para tu cuenta.

Extensiones PHP obligatorias

Además de la versión, PrestaShop necesita ciertas extensiones activadas. En Plesk, puedes verificar esto en la misma sección de "PHP Settings". Busca y asegúrate de que estas extensiones estén marcadas o activadas:

pdo_mysql (imprescindible para la base de datos)
curl (para conexiones externas y módulos)
gd o imagick (para procesar imágenes)
mbstring (para caracteres especiales y acentos)
openssl (para seguridad y SSL)
zip (para instalar módulos y temas)
fileinfo (para detectar tipos de archivo)
intl (para internacionalización y monedas)

[WARNING] Si alguna de estas extensiones no está activa, la instalación fallará o, peor aún, se instalará pero dará errores extraños más adelante. Tómate 5 minutos para verificarlas todas antes de continuar.

Permisos PrestaShop Plesk: La pesadilla de los archivos

Otro de los grandes culpables de que PrestaShop no instale son los permisos de archivos y carpetas. PrestaShop necesita escribir en ciertos directorios para crear archivos de configuración, caché y logs durante la instalación.

Los permisos correctos

En un entorno Plesk, los permisos recomendados son:

Directorios (carpetas): 755
Archivos: 644
Carpeta config: 755
Carpeta var (o cache en versiones antiguas): 755
Carpeta img: 755
Carpeta modules: 755
Carpeta themes: 755
Carpeta translations: 755
Carpeta override: 755

[INFO] No necesitas permisos 777 en ningún caso. Si ves tutoriales que te dicen que pongas 777, son antiguos y además suponen un riesgo de seguridad grave. Con 755 y 644 es más que suficiente.

Cómo cambiar permisos desde Plesk

Ve a la sección "File Manager" de tu dominio en Plesk.
Navega hasta la carpeta donde has subido los archivos de PrestaShop (normalmente httpdocs).
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic en el botón "Permissions" (o "Permisos") en la barra superior.
Cambia los valores según lo indicado arriba: 755 para carpetas y 644 para archivos.
Aplica los cambios.

[TIP] Si el File Manager de Plesk te da problemas con archivos ocultos (como .htaccess), activa la opción de "Show hidden files" en la configuración del File Manager.

El problema del propietario de los archivos

A veces los permisos están bien, pero el propietario de los archivos no es el correcto. En Plesk, los archivos deben pertenecer al usuario del sistema correspondiente a tu suscripción.

Para verificar esto:

En el File Manager, haz clic en un archivo y selecciona "Properties".
Comprueba que el propietario y el grupo coinciden con tu usuario de hosting.
Si no es así, contacta con tu proveedor para que ejecute un chown correcto. No intentes hacerlo tú vía SSH si no tienes experiencia, podrías dejar tu web inservible.

Errores PrestaShop Plesk: La base de datos

La base de datos es el tercer pilar de la instalación. Un error aquí suele manifestarse con mensajes como "Error al conectar con la base de datos" o "No se puede crear la base de datos".

Crear la base de datos correctamente en Plesk

En tu panel de Plesk, ve a la sección "Databases" o "Bases de datos".
Haz clic en "Add Database".
Elige un nombre descriptivo (por ejemplo, prestashop_db).
Selecciona MySQL como tipo de base de datos.
Crea un usuario de base de datos con su contraseña. Anota estos datos, los necesitarás durante la instalación de PrestaShop.
Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos (normalmente se otorgan automáticamente, pero verifica que la casilla esté marcada).

Errores comunes con la base de datos

"Access denied for user": El usuario o contraseña son incorrectos. Revisa que no haya espacios y que hayas copiado bien la contraseña.
"Unknown database": El nombre de la base de datos no coincide. En Plesk, a veces el nombre real incluye un prefijo con tu usuario (por ejemplo, user_prestashop_db). Verifica en el panel cuál es el nombre exacto.
"Connection refused": El servidor de base de datos no está accesible. Esto es más raro, pero puede ocurrir si tu hosting usa servidores de base de datos remotos. Espera unos minutos y reintenta.

[WARNING] Durante la instalación de PrestaShop, cuando te pida el nombre de la base de datos, usa el nombre completo que aparece en Plesk, no el nombre corto que tú elegiste. Este es uno de los errores PrestaShop Plesk más frecuentes.

Guía paso a paso: Solucionar PrestaShop no instala

Ahora que ya hemos cubierto los tres puntos críticos, vamos a hacer una secuencia completa de solución de problemas. Sigue estos pasos en orden y, con casi total seguridad, resolverás el problema.

Paso 1: Verifica los requisitos del servidor

Antes de nada, descarga el archivo compatibility.php de PrestaShop (lo encontrarás en la carpeta tools o en el paquete de instalación en la ruta install/). Súbelo a tu servidor y ábrelo en el navegador. Te dirá exactamente qué requisitos se cumplen y cuáles no.

Si no encuentras este archivo, crea un archivo llamado info.php con este contenido:

<?php
phpinfo();
?>

Súbelo a httpdocs y ábrelo en el navegador. Busca la sección de PHP Configuration y verifica la versión y las extensiones cargadas.

[TIP] Elimina siempre estos archivos de prueba después de usarlos. Dejarlos en el servidor es un riesgo de seguridad.

Paso 2: Limpia y vuelve a subir los archivos

A veces, la descarga del paquete de PrestaShop se corrompe o la subida por FTP se interrumpe. Esto provoca que PrestaShop no instale correctamente.

Elimina todos los archivos de httpdocs.
Descarga de nuevo el paquete de PrestaShop desde la web oficial.
Descomprímelo en tu ordenador.
Sube los archivos mediante el File Manager de Plesk (es más fiable que un FTP externo, ya que no se corta la conexión).
Una vez subido, aplica los permisos que indicamos antes.

Paso 3: Crea una base de datos nueva

No reutilices bases de datos antiguas de intentos fallidos. Pueden tener tablas a medio crear que den conflicto.

En Plesk, elimina la base de datos anterior (si existe).
Crea una base de datos nueva con un nombre distinto.
Crea un usuario nuevo con contraseña nueva.
Anota los datos en un bloc de notas.

Paso 4: Ejecuta la instalación manualmente

Ve a tu dominio y sigue el asistente de instalación. Cuando llegues a la parte de la base de datos, introduce los datos exactamente como aparecen en Plesk.

[INFO] Si el asistente se queda cargando o da error en el paso 3 o 4, vuelve a verificar los permisos de la carpeta config y var. Son las que más problemas dan.

Paso 5: Desactiva temporalmente el caché y el SSL

A veces, el caché de Plesk o un certificado SSL recién instalado interfieren en la instalación.

En Plesk, ve a la configuración del dominio y desactiva el caché de Apache o Nginx temporalmente.
Si tienes SSL activo, prueba a acceder a la instalación por HTTP en lugar de HTTPS (si tu proveedor lo permite).
Una vez instalado, puedes volver a activar todo.

Errores PrestaShop Plesk específicos y sus soluciones

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

Este es un error clásico de permisos. El archivo config/settings.inc.php no tiene permisos de escritura.

Solución: Cambia los permisos de la carpeta config a 755 y el archivo settings.inc.php (si existe) a 644. Si el archivo no existe, es porque no se ha creado todavía; asegúrate de que la carpeta tenga permisos de escritura para el usuario de Plesk.

Error: "Página en blanco después de la instalación"

Esto suele indicar un problema con la caché o con los archivos de la tienda.

Solución:

Borra el contenido de la carpeta var/cache (o cache en versiones antiguas).
Verifica que la versión de PHP es la correcta y que las extensiones están activas.
Revisa los logs de error en Plesk (sección "Logs" del dominio) para ver el error exacto.

Error: "MySQL server has gone away"

Este error indica que la conexión con la base de datos se interrumpe, normalmente por un límite de tiempo o de memoria.

Solución:

Aumenta el límite de memoria de PHP en la configuración de PHP de Plesk (busca memory_limit y ponlo a 256M o 512M).
Aumenta el max_execution_time a 300 o más.
Si el problema persiste, contacta con tu proveedor: el servidor MySQL puede estar configurado con un max_allowed_packet muy bajo.

Error: "Fatal error: Allowed memory size exhausted"

PrestaShop necesita más memoria de la que PHP tiene asignada.

Solución: En la configuración de PHP en Plesk, busca memory_limit y cámbialo a 256M como mínimo. Si no puedes cambiarlo desde el panel, crea un archivo .htaccess en httpdocs con:

php_value memory_limit 256M

[WARNING] Si tu hosting usa PHP-FPM, la directiva .htaccess no funcionará. Tendrás que hacerlo desde el panel de Plesk o contactar con soporte.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en Plesk automáticamente?

Sí, Plesk tiene un instalador de aplicaciones en la sección "Applications". Busca PrestaShop y haz clic en instalar. Sin embargo, este método a veces falla por las mismas razones que la instalación manual. Si el instalador automático falla, sigue los pasos de esta guía.

¿Qué hago si no tengo acceso a la configuración de PHP?

Esto significa que tu plan de hosting es muy básico o que el administrador ha restringido opciones. Contacta con tu proveedor y pide que activen el selector de PHP o que configuren al menos PHP 8.0 con las extensiones necesarias.

¿PrestaShop 1.6 funciona en Plesk?

PrestaShop 1.6 es muy antiguo y usa PHP 5.x, que ya no es seguro. No te recomendamos instalarlo. Si lo necesitas por compatibilidad con un módulo, usa PHP 5.6, pero ten en cuenta que es un riesgo de seguridad importante.

¿El problema puede ser del certificado SSL?

No, el SSL no suele impedir la instalación. Pero si tienes problemas con redirecciones infinitas después de instalar, revisa la configuración de SSL en Plesk y asegúrate de que el dominio no tenga redirección forzada a HTTPS durante el proceso de instalación.

¿Cómo sé si el problema es de mi hosting o de PrestaShop?

Si has seguido todos los pasos y el error persiste, probablemente sea un problema de configuración del servidor que no puedes resolver tú. Contacta con tu proveedor de hosting y diles que has verificado PHP, permisos y base de datos, y que el error persiste. Ellos podrán revisar los logs del servidor con más detalle.

Conclusión final: La clave está en la preparación

La mayoría de los errores PrestaShop Plesk se resuelven con una buena preparación previa. Verifica la versión de PHP, activa las extensiones necesarias, configura los permisos PrestaShop Plesk correctamente y crea una base de datos limpia. Con estos cuatro puntos en orden, la instalación debería ser un proceso fluido de menos de 10 minutos.

Si aun así algo falla, recuerda que siempre puedes consultar los logs de error en Plesk (sección "Logs" de tu dominio) para obtener pistas sobre el problema exacto. Y si te quedas bloqueado, no dudes en contactar con el soporte de tu hosting: para eso están.

[TIP] Guarda esta guía en tus favoritos. Te será útil no solo para la instalación, sino también para futuros problemas de rendimiento o actualizaciones de PrestaShop. La solución de problemas es siempre más fácil cuando entiendes la base.