Errores comunes al instalar PrestaShop en Plesk | Soluciones fáciles

¡Hola! ¿Estás intentando montar tu tienda online con PrestaShop en un servidor Plesk y te has topado con algún error? No te preocupes, es más común de lo que crees. Plesk es un panel de control excelente, pero a veces la configuración de PHP, la memoria o los permisos pueden jugarte una mala pasada.

En esta guía extensa y muy práctica, vamos a desglosar los errores más frecuentes al instalar PrestaShop en Plesk y, lo más importante, te daré la solución paso a paso para que puedas tener tu tienda funcionando en minutos.

Piensa en mí como tu compañero de soporte técnico: voy a explicarte todo en un lenguaje sencillo, sin tecnicismos raros. Vamos allá.

Requisitos previos antes de empezar

Antes de lanzarte a instalar, asegúrate de que tu servidor Plesk cumple con los requisitos mínimos de PrestaShop. Esto te ahorrará muchos dolores de cabeza.

Versión de PHP correcta

PrestaShop 8.x (la versión más moderna) funciona mejor con PHP 8.1 o superior. En Plesk, puedes cambiar la versión de PHP para cada dominio o suscripción.

Ve a Suscripciones y selecciona tu plan.
Haz clic en Hosting y DNS > Configuración de hosting.
Busca la sección PHP y selecciona la versión 8.1 o 8.2.
Guarda los cambios.

[WARNING] Si usas una versión de PHP inferior a 7.4, PrestaShop te dará un error de compatibilidad directamente al iniciar la instalación. No intentes saltarte este paso.

Extensiones PHP necesarias

PrestaShop necesita ciertas extensiones de PHP activadas. En Plesk, es muy fácil gestionarlas:

En la misma sección de Configuración de hosting, busca Extensiones PHP.
Asegúrate de que están habilitadas (marcadas) las siguientes:
- curl
- gd
- json
- mbstring
- openssl
- pdo_mysql
- xml
- zip
- intl

Si alguna falta, actívala y guarda. Esto soluciona el 90% de los errores de instalación.

Error 1: «El directorio no tiene permisos de escritura»

Este es, con diferencia, el error más común al instalar PrestaShop en Plesk. Aparece al principio de la instalación y te dice que la carpeta no se puede escribir.

¿Por qué ocurre?

Plesk, por seguridad, asigna unos permisos muy restrictivos a las carpetas. PrestaShop necesita poder escribir en ciertos directorios (como config, cache, log, img, etc.) para crear archivos de configuración y guardar imágenes.

Solución paso a paso

Accede al administrador de archivos de Plesk.
- Ve a tu dominio, luego a Archivos.
Selecciona la carpeta raíz de PrestaShop. Normalmente se llama httpdocs o prestashop (donde hayas subido los archivos).
Cambia los permisos de forma recursiva.
- Marca la casilla de la carpeta principal.
- Haz clic en Permisos en la barra de herramientas.
- Marca las opciones:
  - Lectura y escritura para el Propietario (el usuario del sistema, suele ser algo como dominio_ftp).
  - Lectura y escritura para el Grupo.
  - Lectura para Otros.
- ¡Importante! Marca la casilla Aplicar a subdirectorios.
- Haz clic en Aceptar.

[TIP] Si después de esto sigues viendo el error, ve a Herramientas y configuraciones > Políticas de seguridad y desmarca temporalmente la opción "Proteger archivos de configuración" si está activada. Luego vuelve a instalarlo y actívala de nuevo.

Error 2: «Límite de memoria PHP insuficiente»

Durante la instalación, o incluso al cargar el backoffice, PrestaShop puede mostrar un mensaje como: "Se ha alcanzado el límite de memoria de PHP".

¿Por qué ocurre?

PrestaShop, especialmente al instalar módulos o temas, necesita un mínimo de 256 MB de memoria PHP. En Plesk, el valor por defecto suele ser 128 MB.

Solución paso a paso

Ve a la configuración de hosting de tu dominio (como hicimos antes).
Busca la sección PHP Settings.
Localiza la variable memory_limit.
Cambia el valor a 512M o, como mínimo, 256M.
También puedes ajustar max_execution_time a 180 (segundos) para evitar que se corte la instalación.
Guarda los cambios.

[INFO] Si no ves la opción memory_limit, puede que esté bloqueada por el administrador del servidor. En ese caso, puedes intentar crearla manualmente en un archivo php.ini local, pero lo más fácil es pedirle a tu proveedor de hosting que lo ajuste.

Error 3: «Error de conexión a la base de datos»

Llegas al paso de la base de datos y te sale: "No se puede conectar al servidor de base de datos" o "El usuario no tiene permisos".

¿Por qué ocurre?

Plesk suele crear bases de datos y usuarios de forma independiente. Es muy común que el usuario creado no tenga permisos sobre la base de datos que acabas de crear.

Solución paso a paso

Crea la base de datos y el usuario en Plesk.
- Ve a tu dominio > Bases de datos.
- Haz clic en Agregar base de datos.
- Ponle un nombre (ej: tienda_prestashop).
- Marca Crear un nuevo usuario.
- Pon un nombre de usuario y una contraseña segura. Anótalos.
Asigna el usuario a la base de datos.
- Una vez creada, haz clic en el nombre de la base de datos.
- Ve a la pestaña Usuarios.
- Asegúrate de que el usuario que acabas de crear aparece en la lista y tiene marcado TODOS los privilegios.
Usa esos datos exactos en la instalación.
- En el instalador de PrestaShop, introduce:
  - Dirección del servidor: localhost (casi siempre es así en Plesk).
  - Nombre de la base de datos: El que creaste (ej: tienda_prestashop).
  - Usuario: El que creaste.
  - Contraseña: La que pusiste.

[WARNING] No uses el usuario root ni la base de datos por defecto de Plesk. Crea siempre una nueva para PrestaShop.

Error 4: «Error 500 - Internal Server Error» después de la instalación

Has instalado PrestaShop, todo parece bien, pero al entrar a la tienda o al panel de administración ves una página en blanco o un error 500.

¿Por qué ocurre?

Suele deberse a un archivo .htaccess corrupto o a un módulo incompatible que se activó al finalizar la instalación.

Solución paso a paso

Renombra el archivo .htaccess.
- Ve al administrador de archivos de Plesk.
- Busca el archivo .htaccess en la raíz de PrestaShop.
- Cámbiale el nombre a .htaccess_old.
- Vuelve a cargar tu tienda. Si funciona, el problema está en el .htaccess.
Regenera el .htaccess desde el backoffice.
- Accede a tu panel de administración (ej: tudominio.com/admin123).
- Ve a Configuración de la tienda > Rendimiento.
- Haz clic en Limpiar caché.
- Luego ve a Parámetros de la tienda > SEO y URLs.
- Haz clic en Guardar (esto regenera el .htaccess).
Si el error persiste, revisa los logs de error.
- En Plesk, ve a tu dominio > Registros > Registro de errores.
- Busca la línea que diga PHP Fatal error. Ahí te dirá exactamente qué archivo o módulo está fallando.

Error 5: «La URL de la tienda no es correcta» o redirecciones infinitas

Al instalar, pusiste una URL temporal (como una IP o un dominio de prueba) y luego la cambiaste, o simplemente la tienda no carga bien con el dominio definitivo.

¿Por qué ocurre?

PrestaShop guarda la URL de la tienda en la base de datos. Si la cambias manualmente o el dominio no está bien configurado en Plesk, se produce un bucle de redirección.

Solución paso a paso

Accede a la base de datos desde Plesk.
- Ve a Bases de datos y haz clic en phpMyAdmin al lado de tu base de datos.
Busca la tabla ps_configuration (o prestashop_configuration).
Localiza las filas:
- PS_SHOP_DOMAIN
- PS_SHOP_DOMAIN_SSL
Edítalas y pon tu dominio completo, sin http:// ni https://. Por ejemplo: tudominio.com.
También busca la tabla ps_shop_url y asegúrate de que el campo domain y domain_ssl tengan el mismo valor.

[TIP] Si no puedes acceder al backoffice, esta es la única forma de arreglarlo. Es más fácil de lo que parece.

FAQ: Preguntas frecuentes sobre PrestaShop y Plesk

¿Puedo instalar PrestaShop automáticamente desde el instalador de Plesk?

Sí, muchos servidores Plesk incluyen un instalador de aplicaciones (como Softaculous o el propio instalador de Plesk). Es la forma más rápida y evita muchos errores. Si lo usas, el sistema se encarga de los permisos y la base de datos.

¿Qué hago si el instalador se queda en "cargando" en el paso 3 o 4?

Esto suele ser por un tiempo de ejecución de PHP muy bajo. Aumenta max_execution_time a 300 segundos como te expliqué antes. También puede ser por falta de memoria, así que sube también memory_limit.

¿PrestaShop funciona con PHP 8.2 en Plesk?

Sí, perfectamente. Las últimas versiones de PrestaShop (8.x) son compatibles con PHP 8.2. Solo asegúrate de tener las extensiones correctas activadas.

¿Cómo activo el modo de depuración para ver errores ocultos?

Si ves una página en blanco, activa el modo debug:

Abre el archivo config/defines.inc.php en la raíz de PrestaShop.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda y recarga la página. Ahora verás el error detallado.

[WARNING] No olvides volver a ponerlo en false cuando termines de depurar, o tu tienda mostrará información sensible a los visitantes.

Mi hosting usa Syspanel (HestiaCP), ¿esto sirve igual?

Aunque esta guía está enfocada a Plesk, muchos conceptos son universales. Si usas Syspanel (el nombre que le damos a HestiaCP), recuerda que el acceso es por el puerto 2106 (ej: tudominio.com:2106). La gestión de bases de datos y PHP es similar, pero los permisos de archivos se gestionan desde el administrador de archivos de Syspanel. Los errores comunes son los mismos.

Resumen final: Lista de verificación rápida

Antes de dar por terminada la instalación, repasa esta lista:

PHP 8.1+ activado en Plesk.
Extensiones PHP (curl, gd, json, mbstring, etc.) habilitadas.
Permisos 755 en carpetas y 644 en archivos (o permisos de escritura para el propietario).
Memoria PHP de al menos 256 MB.
Base de datos creada con usuario dedicado y todos los privilegios.
URL de la tienda correcta en la base de datos (si migraste).
Modo debug desactivado tras la instalación.

Con estos pasos, deberías poder instalar PrestaShop en Plesk sin mayores contratiempos. Si te encuentras con un error que no está en esta lista, no dudes en escribirme. ¡Estoy aquí para ayudarte a montar tu tienda online!

¡Buena suerte con tu PrestaShop!