Errores comunes al instalar PrestaShop en Plesk y soluciones

Antes de empezar: ¿Por qué aparecen estos errores al instalar PrestaShop en Plesk?

Cuando intentas instalar PrestaShop en un servidor con Plesk, es muy común encontrarse con pantallas en blanco, errores como el 500 Internal Server Error, el 403 Forbidden o incluso problemas de permisos que te impiden avanzar.

La buena noticia es que la mayoría de estos fallos tienen una solución clara y no requieren que seas un experto en sistemas. En esta guía extensa, te voy a explicar paso a paso cómo diagnosticar y corregir los problemas más habituales para que puedas completar la instalación de tu tienda online sin frustraciones.

Vamos a centrarnos en los errores que más aparecen en los foros y en las consultas de soporte: el temido error 500 PrestaShop Plesk, los problemas de permisos de archivos y las configuraciones de PHP que dan al traste con la instalación.

¿Qué significa cada error y por qué ocurre?

Antes de lanzarnos a tocar archivos, es fundamental que entiendas qué te está diciendo el servidor. Así podrás aplicar la solución correcta sin perder tiempo.

Error 500 Internal Server Error

Este es, sin duda, el más común y el más frustrante. Un error 500 significa que algo ha fallado en el servidor, pero no te dice exactamente el qué.

Las causas más frecuentes al instalar PrestaShop en Plesk son:

Versión de PHP incorrecta o incompatible con la versión de PrestaShop que intentas instalar.
Límite de memoria PHP demasiado bajo (el clásico memory_limit).
Permisos de archivos y carpetas incorrectos.
Archivos .htaccess corruptos o con directivas que el servidor no entiende.
Módulos de PHP deshabilitados que PrestaShop necesita sí o sí (como curl, gd, openssl o pdo_mysql).

Error 403 Forbidden

El 403 te indica que el servidor ha entendido tu petición, pero se niega a mostrarte el contenido. Es un problema de permisos, casi siempre.

Al intentar instalar PrestaShop, este error suele aparecer por:

Permisos de carpetas demasiado restrictivos (por ejemplo, 644 en una carpeta que debería ser 755).
El archivo index.php no tiene permisos de lectura.
Un .htaccess con reglas que bloquean el acceso.
El dominio no apunta correctamente a la carpeta httpdocs o htdocs en Plesk.

Pantalla en blanco o instalación que se queda a medias

A veces no ves ni un error, solo una página en blanco. Esto suele estar relacionado con:

Errores de PHP ocultos que no se muestran en pantalla.
Falta de extensiones PHP críticas.
Problemas con la base de datos MySQL (usuario sin permisos, contraseña incorrecta, etc.).

Requisitos previos antes de tocar nada

Te recomiendo que antes de empezar a modificar configuraciones, revises estos puntos en tu panel de Plesk. Son la base de todo y te ahorrarán muchos quebraderos de cabeza.

[!TIP]
Si tu hosting es de tipo compartido y usas Plesk, es posible que algunas opciones avanzadas estén bloqueadas. En ese caso, contacta con tu proveedor y muéstrale esta guía. La mayoría de los problemas se resuelven en el administrador de dominios o en las políticas de PHP.

1. Comprueba la versión de PrestaShop y de PHP

PrestaShop 8.x requiere PHP 7.2.5 o superior, siendo ideal PHP 7.4 o PHP 8.0. Si intentas instalar una versión antigua de PrestaShop (como la 1.6) con PHP 8.0, tendrás errores graves.

Para ver y cambiar la versión de PHP en Plesk:

Entra en tu panel de Plesk.
Ve a Dominios y selecciona tu dominio.
Busca la sección Configuración de PHP (o "PHP Settings").
Cambia la versión a una compatible (te recomiendo PHP 7.4 si tienes dudas, es la más estable para PrestaShop).
Guarda los cambios y vuelve a intentar la instalación.

2. Activa las extensiones PHP necesarias

PrestaShop necesita una serie de extensiones para funcionar. En Plesk, puedes activarlas desde la misma sección de configuración de PHP.

Las imprescindibles son:

curl
gd
intl
mbstring
openssl
pdo_mysql
zip

[!WARNING]
Si alguna de estas extensiones no está activa, la instalación fallará sí o sí, aunque no veas un error claro. A veces solo verás un aviso en el instalador, pero otras veces simplemente se queda en blanco la página.

3. Revisa el espacio en disco y los límites del servidor

PrestaShop necesita espacio para descomprimir el archivo y crear las carpetas de caché. Si tu plan de hosting es muy limitado, puedes quedarte sin espacio a mitad de instalación.

Soluciones paso a paso para el error 500 en PrestaShop con Plesk

Vamos a ir directos al grano. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Activa la visualización de errores PHP

El primer paso es hacer que el servidor te diga qué está fallando. Por defecto, Plesk oculta los errores de PHP en pantalla.

Para verlos:

Ve a Configuración de PHP en tu dominio.
Busca la opción display_errors y cámbiala a On.
También activa log_errors y pon error_reporting a E_ALL.
Guarda los cambios.

Ahora, vuelve a intentar la instalación. Si aparece un mensaje de error en pantalla, tendrás una pista clara. Los más comunes son:

"Fatal error: Allowed memory size..." → Necesitas subir el límite de memoria.
"Class not found" → Falta una extensión PHP.
"Permission denied" → Problema de permisos en archivos o carpetas.

Paso 2: Aumenta el límite de memoria PHP

Este es uno de los culpables más habituales del error 500 PrestaShop Plesk. La instalación de PrestaShop consume mucha memoria, especialmente al crear las tablas de la base de datos.

En la misma sección de configuración de PHP, busca memory_limit y súbelo. Te recomiendo poner 256M como mínimo, aunque 512M es más seguro.

Guarda los cambios y prueba de nuevo.

Paso 3: Corrige los permisos de archivos y carpetas

Este paso es crucial. PrestaShop necesita escribir en ciertas carpetas para funcionar, y si los permisos no son los correctos, aparecerá el error 500 o el 403.

Los permisos correctos para una instalación estándar son:

Carpetas: 755
Archivos: 644
Carpetas de caché y configuración: 755 (a veces necesitan 777 temporalmente durante la instalación)

En Plesk, puedes cambiar los permisos desde el administrador de archivos:

Ve a Administrador de Archivos en tu dominio.
Selecciona todos los archivos y carpetas de PrestaShop.
Haz clic en Cambiar permisos.
Pon las carpetas en 755 y los archivos en 644.
Aplica los cambios.

[!WARNING]
Si estás en un servidor con modo suPHP o CGI, los permisos deben ser más estrictos. Si usas FastCGI o FPM, los permisos 755/644 suelen funcionar bien. En caso de duda, contacta con tu proveedor.

Paso 4: Elimina el archivo .htaccess temporalmente

A veces, un .htaccess corrupto o con directivas incompatibles puede provocar el error 500. Para comprobarlo:

Ve al administrador de archivos.
Busca el archivo .htaccess en la raíz de tu dominio.
Renómbralo a .htaccess.bak (no lo borres, por si acaso).
Intenta la instalación de nuevo.

Si funciona, el problema está en el .htaccess. Puedes generar uno nuevo desde el panel de administración de PrestaShop después de la instalación, o copiar el de la carpeta install (si existe).

Paso 5: Verifica la configuración de la base de datos

El error 500 también puede aparecer si la base de datos no está bien configurada. Al instalar PrestaShop, el instalador te pide los datos de conexión a MySQL.

Asegúrate de que:

El nombre de la base de datos es correcto.
El usuario tiene permisos totales sobre esa base de datos.
La contraseña no tiene caracteres especiales que puedan dar problemas (aunque Plesk suele gestionarlo bien).

[!TIP]
En Plesk, cuando creas una base de datos, también se crea un usuario. Asegúrate de usar ese usuario y no uno genérico. Ve a Bases de Datos en tu dominio y verifica los datos.

Paso 6: Sube los archivos de PrestaShop de nuevo

A veces, el problema es que la subida de archivos por FTP se ha interrumpido o ha dejado archivos incompletos.

Te recomiendo:

Borra todos los archivos de PrestaShop de tu servidor (a través del administrador de archivos).
Vuelve a subir el archivo ZIP desde tu ordenador.
Descomprime el ZIP en el servidor (Plesk tiene una opción para esto en el administrador de archivos).
Asegúrate de que todos los archivos se han descomprimido correctamente.

Soluciones específicas para el error 403 en Plesk

El 403 es más fácil de solucionar que el 500, ya que casi siempre es un tema de permisos.

Verifica el índice del directorio

Plesk suele tener un archivo index.html por defecto en la raíz del dominio. Si PrestaShop no tiene su propio index.php bien ubicado, el servidor intentará mostrar el índice del directorio y te dará el 403.

Para solucionarlo:

Asegúrate de que has subido los archivos a la carpeta correcta (normalmente httpdocs).
Comprueba que existe un archivo index.php en esa carpeta.
Si no existe, sube los archivos de PrestaShop de nuevo.

Revisa las directivas de Apache

En Plesk, puedes tener reglas de Apache personalizadas que bloqueen el acceso.

Ve a Apache y nginx en la configuración de tu dominio.
Busca directivas como Deny from all o Require all denied.
Elimínalas si las encuentras.
Guarda los cambios y prueba.

Configura el documento raíz correctamente

A veces, el dominio apunta a una subcarpeta que no existe. En Plesk:

Ve a Configuración del sitio web (o "Website & Domains").
Busca la opción Documento raíz.
Asegúrate de que apunta a /httpdocs (o /htdocs).

Problemas comunes al instalar PrestaShop en Plesk y sus soluciones rápidas

Aquí tienes un resumen de los problemas más típicos y cómo atajarlos:

La instalación se queda en el paso de "Crear base de datos"

Causa: El usuario de la base de datos no tiene permisos.
Solución: En Plesk, ve a Bases de Datos, selecciona tu base, y en Usuarios asegúrate de que el usuario tiene marcada la casilla de "Privilegios" adecuados (normalmente todos).

Aparece un error de "permisos de escritura" en el instalador

Causa: Las carpetas config, cache o log no tienen permisos de escritura.
Solución: Temporalmente, pon esas carpetas a 777, instala PrestaShop, y luego vuelve a ponerlas a 755.

El instalador no reconoce la versión de PHP

Causa: Estás usando una versión de PHP muy antigua o muy nueva.
Solución: Cambia a PHP 7.4 en la configuración de Plesk. Es la versión más compatible.

Error al conectar con la base de datos MySQL

Causa: Los datos de conexión son incorrectos.
Solución: Verifica en Plesk que el nombre de la base, el usuario y la contraseña son exactamente los que estás usando en el instalador.

Preguntas frecuentes (FAQ) sobre errores de instalación de PrestaShop

¿Puedo instalar PrestaShop con PHP 8.0 en Plesk?

Sí, pero solo si usas PrestaShop 8.x. Las versiones 1.7.x antiguas no son compatibles con PHP 8.0 y darán errores. Mi recomendación es usar PHP 7.4 para máxima estabilidad.

¿Qué hago si no veo la opción de cambiar la versión de PHP en Plesk?

Si tu plan de hosting no te permite cambiar la versión de PHP, contacta con tu proveedor. Algunos planes compartidos tienen PHP fijo.

¿Necesito crear la base de datos antes de instalar PrestaShop?

Sí, es recomendable. Ve a Bases de Datos en Plesk, crea una nueva base con su usuario y contraseña, y ten esos datos a mano cuando el instalador te los pida.

¿El error 500 puede deberse a un problema de nginx?

Sí, en Plesk a veces nginx actúa como proxy inverso y puede dar problemas. Ve a Apache y nginx y desactiva el proxy de nginx temporalmente para probar.

¿Por qué me sale un error 403 al acceder a la carpeta /admin de PrestaShop?

Esto es un problema de permisos en la carpeta /admin. Asegúrate de que la carpeta tiene permisos 755 y que el archivo index.php dentro de ella tiene permisos 644.

Conclusión y consejos finales

Resolver el error instalar PrestaShop Plesk es cuestión de ir descartando causas. La mayoría de las veces, el problema está en la versión de PHP o en los permisos de los archivos.

Mi consejo final es que sigas este orden:

Actualiza PHP a 7.4 y activa todas las extensiones.
Sube la memoria a 256M.
Corrige los permisos a 755/644.
Elimina el .htaccess temporalmente.
Prueba la instalación.

Si aún así sigue sin funcionar, activa la visualización de errores y busca el mensaje exacto en Google. Con esa información, podrás encontrar soluciones muy específicas.

[!INFO]
Recuerda que si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el puerto de acceso al panel es el 2106. Aunque esta guía está enfocada en Plesk, muchos de los conceptos (permisos, PHP, extensiones) son aplicables a cualquier panel de control.

Espero que esta guía extensa te haya sido de ayuda. No dudes en dejar tus preguntas en los comentarios si algo no te queda claro. ¡Buena suerte con tu tienda online!