Errores comunes en instalación PrestaShop con Plesk y soluciones

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

Instalar PrestaShop en Plesk es un proceso bastante sencillo, pero no está exento de contratiempos. La mayoría de los errores que verás a continuación no son culpa tuya ni del panel, sino de pequeños detalles de configuración que se pasan por alto. Cosas como la versión de PHP, los permisos de carpetas o la memoria límite son las responsables del 90% de los problemas.

En esta guía vamos a repasar los errores más comunes al instalar PrestaShop en Plesk y, lo más importante, cómo solucionarlos paso a paso. No necesitas ser un experto en servidores, solo seguir las instrucciones con calma.

Error 1: Pantalla blanca o error 500 al instalar

Este es, sin duda, el más frustrante. Acabas de subir los archivos, ejecutas el instalador y... nada. Pantalla en blanco o un error 500. La causa principal suele ser un problema con la memoria PHP o con la versión de PHP que tienes asignada al dominio.

Solución paso a paso

Verifica la versión de PHP en Plesk: Entra en tu panel de Plesk, ve a tu dominio y haz clic en "Configuración de PHP". Asegúrate de que estás usando una versión compatible con PrestaShop (PHP 7.4, 8.0 o 8.1 son las más seguras).
Aumenta el límite de memoria: En la misma pantalla, busca la opción memory_limit. El valor mínimo recomendado es 256M. Si ves que pone 128M o menos, cámbialo y guarda.
Comprueba el registro de errores: En Plesk, ve a "Registros" dentro de tu dominio y busca el archivo de logs de errores. Ahí verás el mensaje exacto. Si no entiendes nada, busca la frase "PHP Fatal error" y anota qué dice.

[TIP] Si después de estos cambios sigues viendo el error, prueba a desactivar la caché de PHP (OPcache) temporalmente desde la configuración de PHP. A veces la caché guarda datos corruptos de instalaciones anteriores.

Error 2: "La extensión mysqli no está disponible" o "Falta la extensión PDO"

PrestaShop necesita ciertas extensiones de PHP para funcionar. Si ves este error, es porque Plesk no tiene habilitadas las extensiones necesarias para tu dominio.

Solución paso a paso

Accede a la configuración de PHP: Igual que en el paso anterior, ve a "Configuración de PHP" de tu dominio.
Habilita las extensiones: Busca en la lista las extensiones mysqli, pdo_mysql, curl, gd, openssl y zip. Marca las casillas que no estén activadas.
Guarda los cambios: Plesk reiniciará PHP automáticamente. Espera unos segundos y vuelve a intentar la instalación.

[WARNING] No marques todas las extensiones sin saber qué hacen. Algunas pueden entrar en conflicto con otras aplicaciones que tengas en el mismo dominio. Solo activa las que te pida PrestaShop.

Error 3: Problemas con los permisos de archivos y carpetas

Este es un clásico en errores PrestaShop Plesk. El instalador necesita escribir en ciertas carpetas para crear archivos de configuración. Si los permisos no son correctos, verás mensajes como "No se puede escribir en /config" o "El archivo settings.inc.php no se puede crear".

Solución paso a paso

Conecta por FTP o usa el Administrador de archivos de Plesk: Entra en tu dominio y navega hasta la carpeta donde has subido PrestaShop.
Cambia los permisos de las carpetas: Las carpetas que necesitan permisos de escritura son:
- /config
- /cache
- /log
- /img
- /mails
- /modules
- /themes
- /var
- /translations
- /upload
- /download
Asigna permisos 755 a carpetas y 644 a archivos: En Plesk, selecciona las carpetas, haz clic en "Permisos" y escribe 755. Para archivos, usa 644.

[INFO] Si estás usando un servidor con PHP-FPM, a veces necesitas que el usuario del sistema tenga permisos de propietario. En el Administrador de archivos de Plesk, busca la opción "Cambiar propietario" y selecciona el usuario del dominio.

Error 4: "No se pudo conectar a la base de datos" o "Error al crear la base de datos"

Este error aparece cuando los datos de conexión a la base de datos MySQL son incorrectos o cuando la base de datos no tiene los privilegios necesarios.

Solución paso a paso

Crea una base de datos nueva desde Plesk: Ve a "Bases de datos" en tu dominio y crea una nueva. Anota el nombre, el usuario y la contraseña tal cual aparecen.
Revisa el nombre del servidor de base de datos: En la mayoría de los casos, el host es localhost. Pero en Plesk, a veces es una dirección IP o un nombre como mysql.example.com. Puedes verlo en la pantalla de creación de la base de datos.
Comprueba los privilegios del usuario: Asegúrate de que el usuario de la base de datos tenga "Todos los privilegios" sobre esa base de datos. En Plesk, edita el usuario y marca la opción "Todos los privilegios".

[WARNING] No uses el usuario root de MySQL para instalar PrestaShop. Siempre crea un usuario específico para la base de datos. Es más seguro y evita conflictos con otras aplicaciones.

Error 5: El instalador se queda en "Paso 3" o "Paso 4" sin avanzar

A veces el instalador de PrestaShop se queda congelado en un paso concreto, especialmente en el paso de configuración de la tienda o en el de la base de datos. Esto suele deberse a un problema con el tiempo de ejecución de PHP.

Solución paso a paso

Aumenta el tiempo máximo de ejecución: En la configuración de PHP, busca max_execution_time y cámbialo a 300 (5 minutos).
Aumenta el límite de post y upload: Busca post_max_size y upload_max_filesize y ponlos a 64M o más.
Desactiva el modo seguro de PHP: Si tienes safe_mode activado, desactívalo. PrestaShop no es compatible con esta función obsoleta.

[TIP] Si el problema persiste, descarga los archivos de instalación de PrestaShop nuevamente. Puede que el archivo ZIP se haya descargado incompleto o corrupto. Vuelve a subirlo con FTP y sobrescribe todos los archivos.

Error 6: "El archivo .htaccess no se puede crear" o errores de reescritura de URL

PrestaShop necesita un archivo .htaccess para las URLs amigables. Si este archivo no se crea correctamente, verás errores de "404 Not Found" o de "Internal Server Error" al navegar por la tienda.

Solución paso a paso

Crea el archivo .htaccess manualmente: Conecta por FTP y crea un archivo llamado .htaccess en la raíz de PrestaShop.
Desactiva y reactiva las URLs amigables: Ve al panel de administración de PrestaShop, a "Parámetros avanzados > SEO y URLs". Desactiva la opción "URLs amigables", guarda, vuelve a activarla y guarda de nuevo.
Verifica la configuración de Apache: En Plesk, ve a tu dominio y busca "Apache y nginx". Asegúrate de que la opción "Soporte para .htaccess" esté activada.

[WARNING] Si tienes nginx como proxy delante de Apache, la configuración es diferente. En Plesk, activa la opción "Proxy mode" o "Servir archivos estáticos directamente" en la configuración de nginx para evitar conflictos.

Error 7: Problemas con la caché de PrestaShop

Después de instalar, puede que veas errores raros como "La clase CacheMemcached no existe" o problemas de rendimiento. Esto se debe a que PrestaShop intenta usar un sistema de caché que no está disponible en tu servidor.

Solución paso a paso

Entra al panel de administración: Si puedes acceder, ve a "Parámetros avanzados > Rendimiento".
Cambia el sistema de caché: En la lista "Sistema de caché", selecciona "Sin caché" o "Caché de archivos" si está disponible.
Limpia la caché manualmente: Si no puedes entrar al panel, conecta por FTP y borra el contenido de la carpeta /var/cache. No borres la carpeta, solo su contenido.

[INFO] Si tu servidor no tiene instalado Memcached o Redis, no intentes configurarlos desde PrestaShop. Usa la caché de archivos, que es la más compatible con Plesk.

Error 8: La tienda se ve sin estilos o sin imágenes

Este error es muy visual y fácil de detectar. La página carga pero sin CSS, sin imágenes o con el diseño roto. La causa suele ser una URL incorrecta en la configuración o un problema con los permisos de la carpeta /img.

Solución paso a paso

Revisa la URL de la tienda: En el panel de administración, ve a "Parámetros avanzados > Configuración general". Asegúrate de que la URL de la tienda no tiene http:// o https:// duplicado.
Regenera las miniaturas de imágenes: Ve a "Diseño > Imágenes" y haz clic en "Regenerar miniaturas". Espera a que termine.
Comprueba los permisos de la carpeta /img: Asegúrate de que tiene permisos 755 y que el propietario es el usuario del dominio.

[TIP] Si las imágenes se ven rotas pero los archivos existen en el servidor, prueba a cambiar el formato de imagen en "Parámetros avanzados > Rendimiento". A veces el formato WebP no es compatible con tu navegador o servidor.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en Plesk sin conocimientos técnicos?

Sí, Plesk está diseñado para ser amigable. Si sigues los pasos del instalador de PrestaShop y esta guía para resolver errores, podrás hacerlo. Solo necesitas paciencia y seguir las instrucciones al pie de la letra.

¿Qué versión de PHP necesito para PrestaShop 8?

PrestaShop 8 funciona perfectamente con PHP 7.4, 8.0 y 8.1. Evita PHP 8.2 o superior, ya que puede dar problemas de compatibilidad con algunos módulos.

¿Puedo usar MySQL y MariaDB en Plesk para PrestaShop?

Sí, ambos son compatibles. Plesk suele incluir MariaDB por defecto, que es una alternativa de código abierto a MySQL y funciona igual de bien.

¿Qué hago si el instalador de PrestaShop no arranca?

Primero, comprueba que has subido los archivos a la carpeta correcta (normalmente httpdocs o public_html). Luego, revisa los permisos de la carpeta raíz y asegúrate de que el archivo index.php existe.

¿Cómo accedo al panel de administración después de instalar?

Normalmente, la URL es tudominio.com/admin. Si has cambiado la carpeta de administración durante la instalación, usa esa. Si no recuerdas la URL, revisa el archivo config/settings.inc.php y busca la variable _ADMIN_DIR_.

Consejos finales para evitar futuros errores

Una vez que hayas solucionado los problemas instalación PrestaShop en Plesk, te recomiendo hacer lo siguiente para mantener tu tienda estable:

Actualiza PrestaShop regularmente: Las versiones antiguas tienen vulnerabilidades y errores que se corrigen en las nuevas.
Haz copias de seguridad: Plesk tiene herramientas de backup automáticas. Actívalas para que se hagan copias diarias de tu base de datos y archivos.
No instales módulos de dudosa procedencia: Un módulo mal codificado puede romper toda tu tienda. Descarga solo de la tienda oficial de PrestaShop o de desarrolladores de confianza.
Mantén un registro de los cambios: Si modificas la configuración de PHP o de Apache, anota qué has cambiado y cuándo. Así será más fácil revertir si algo sale mal.

[INFO] Si después de seguir todos estos pasos sigues teniendo problemas, contacta con tu proveedor de hosting. A veces hay restricciones a nivel de servidor que solo ellos pueden modificar. Explícales que necesitas ayuda con errores PrestaShop Plesk y dales el mensaje exacto del error que ves.

Recuerda que la paciencia es clave. Cada error que soluciones te enseñará algo nuevo sobre cómo funciona tu servidor y PrestaShop. Con esta guía, la mayoría de los problemas comunes se resuelven en menos de 30 minutos. ¡Ánimo!