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

Introducción: La frustración de un error en la instalación

Instalar PrestaShop en un servidor Plesk es, en teoría, un proceso sencillo. Pero la realidad, como siempre en el mundo del hosting, es que pueden aparecer errores inesperados. Ver una pantalla en blanco, un código de error críptico o un mensaje de "permiso denegado" puede ser desalentador, especialmente si no eres un experto en sistemas.

No te preocupes. La mayoría de los problemas de instalación de PrestaShop en Plesk tienen soluciones claras y, a menudo, rápidas. Este artículo está diseñado como una guía de primeros auxilios para los errores PrestaShop Plesk más comunes. Vamos a desglosar cada problema, explicar por qué ocurre y, lo más importante, darte los pasos exactos para solucionar PrestaShop Plesk de una vez por todas.

Piensa en mí como tu compañero de soporte técnico. Vamos a arreglar esto juntos, paso a paso, sin tecnicismos innecesarios. Al final de esta guía, tendrás tu tienda online funcionando o, al menos, sabrás exactamente qué decirle a tu proveedor de hosting o qué buscar en el panel de Plesk.

Error 1: El temido "Error 500 Internal Server Error"

Este es, sin duda, el error más común al enfrentar problemas instalación PrestaShop. Es un mensaje genérico que indica que algo falló en el servidor, pero no te dice qué. Piensa en ello como una caja cerrada con llave; necesitamos abrirla para ver qué hay dentro.

¿Por qué ocurre?

Las causas más frecuentes son:

Permisos de archivos incorrectos: PrestaShop necesita leer y escribir en ciertos archivos (como config/settings.inc.php o la carpeta cache). Si los permisos son demasiado restrictivos, el servidor no puede ejecutar el código.
Versión de PHP incompatible: PrestaShop es exigente con la versión de PHP. Si tu dominio en Plesk usa una versión muy antigua o muy nueva, el script se rompe.
Archivos .htaccess corruptos o incompletos: Este archivo es vital para las reglas de reescritura de URL y la seguridad. Si se subió incompleto o con errores, todo el sitio falla.
Límite de memoria agotado: Si tu plan de hosting tiene poca memoria PHP asignada, la instalación puede colapsar.

Cómo solucionarlo en Plesk

Vamos a diagnosticar y arreglar el problema paso a paso.

Paso 1: Activa el modo de depuración de PrestaShop

La mejor manera de ver el error real es decirle a PrestaShop que te lo muestre. Debes editar el archivo config/defines.inc.php que está en la raíz de tu instalación.

Ve a Archivos en tu panel de Plesk.
Navega hasta la carpeta httpdocs (o public_html) donde instalaste PrestaShop.
Abre la carpeta config y busca el archivo defines.inc.php.
Haz clic derecho sobre él y selecciona Editar (o usa el editor de archivos de Plesk).
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala a define('_PS_MODE_DEV_', true);.
Guarda los cambios.

Ahora, recarga tu sitio. En lugar del Error 500, verás un mensaje de error PHP detallado con la ruta del archivo y la línea del problema. Esto te dará una pista exacta.

Paso 2: Corrige los permisos de archivos y carpetas

Si el error habla de "permiso denegado" o "no se puede escribir", este es tu problema.

En Plesk, ve a Archivos.
Selecciona TODOS los archivos y carpetas de tu instalación de PrestaShop (la carpeta httpdocs completa).
Haz clic en el botón Permisos (o "Change Permissions").
Establece los siguientes valores:
- Archivos: 644 (el propietario puede leer/escribir, el grupo y otros solo leer).
- Carpetas: 755 (el propietario puede leer/escribir/ejecutar, el grupo y otros solo leer/ejecutar).
Aplica los cambios.

[WARNING]

Evita usar permisos 777 (todos pueden escribir). Es un grave riesgo de seguridad. Con 644 y 755 es suficiente para que PrestaShop funcione correctamente en Plesk.

Paso 3: Verifica la versión de PHP

En Plesk, ve a tu dominio y busca la sección PHP Settings (o "Configuración de PHP").
Asegúrate de que la versión sea compatible con tu versión de PrestaShop. Para PrestaShop 1.7 y 8.x, se recomienda PHP 7.4 o PHP 8.0.
También, en esta misma sección, sube el memory_limit a al menos 256M (o más si tu plan lo permite). Esto evita el error de memoria.

Paso 4: Regenera el archivo .htaccess

A veces, el archivo .htaccess se corrompe durante la subida.

Ve a Archivos en Plesk.
Busca el archivo .htaccess en la raíz de tu instalación.
No lo borres, pero renómbralo a .htaccess_old (esto lo desactiva).
Ve a tu panel de administración de PrestaShop (si puedes acceder). Si no puedes, tendrás que crear uno nuevo.
Ve a Parámetros avanzados -> Rendimiento y haz clic en el botón Guardar (esto regenera el archivo .htaccess).
Si no puedes acceder al panel, crea un archivo vacío llamado .htaccess y súbelo. A veces, con solo regenerarlo, el problema se resuelve.

Error 2: "Permiso denegado" al intentar acceder a la carpeta de instalación

Este error suele aparecer después de subir los archivos de PrestaShop mediante FTP o el administrador de archivos de Plesk. Es frustrante porque has subido todo correctamente, pero el servidor te bloquea.

La causa raíz

El propietario del archivo no es el usuario del sistema (normalmente www-data o el usuario de Plesk). Cuando subes archivos por FTP, el propietario es tu usuario FTP, pero el servidor web ejecuta los scripts como otro usuario. Esto causa un conflicto de permisos.

La solución en Plesk

Plesk tiene una herramienta que corrige esto automáticamente.

Ve a tu dominio en Plesk.
Busca la sección Hosting o Sitio web.
Haz clic en Permisos de escritura (o "Web Scripting").
Marca la opción "Usar el mismo usuario para el servidor web y el acceso FTP" (o similar). Plesk aplicará los propietarios correctos automáticamente.
Si no encuentras esta opción, puedes usar el comando chown desde el acceso SSH (si lo tienes), pero la opción gráfica de Plesk es más segura para principiantes.

[TIP]

Si tienes acceso a la terminal (SSH) desde Plesk, puedes ejecutar: chown -R <usuario>:psaserv httpdocs/ (reemplaza <usuario> con tu nombre de usuario de Plesk). Esto garantiza que todos los archivos sean propiedad del usuario correcto.

Error 3: El instalador se queda en la pantalla de "Carga de archivos" o "Comprobación de requisitos"

Este es un problema instalación PrestaShop muy común. El proceso se detiene en la primera o segunda etapa, a menudo mostrando una rueda de carga infinita o un mensaje de error en la comprobación de requisitos.

Diagnóstico: Archivos incompletos o requisitos del servidor

Las causas más probables son:

Subida de archivos incompleta: Si usaste FTP y la conexión se cortó, algunos archivos estarán corruptos o faltarán.
Faltan extensiones de PHP: PrestaShop necesita ciertas extensiones (como curl, gd, mysqli, openssl, etc.). Si no están activadas en Plesk, el instalador se detiene.
El archivo config/settings.inc.php no se puede crear: Este archivo se genera durante la instalación. Si la carpeta config no tiene permisos de escritura, falla.

Solución paso a paso

Paso 1: Re-subir los archivos

La solución más fiable es volver a subir el paquete de instalación.

Descarga el archivo ZIP de PrestaShop desde el sitio oficial.
Descomprímelo en tu computadora (no lo subas comprimido).
Usa el Administrador de Archivos de Plesk (no FTP) para subir los archivos. El administrador de archivos es más tolerante y no corta la conexión.
Sube los archivos a la carpeta httpdocs (o public_html).

Paso 2: Verifica y activa las extensiones de PHP

En Plesk, ve a PHP Settings de tu dominio.
Busca una lista de extensiones (a menudo se llaman "Opciones de PHP" o "Extensiones").
Asegúrate de que las siguientes estén activadas (marcadas):
- curl
- gd
- mysqli
- openssl
- mbstring
- zip
- intl
Guarda los cambios y reinicia PHP si Plesk te lo pide.

Paso 3: Crea manualmente el archivo settings.inc.php

Si el instalador falla al crear el archivo de configuración, puedes crearlo tú mismo.

Ve a la carpeta config en tu instalación.
Crea un archivo nuevo llamado settings.inc.php.
Edítalo con el siguiente contenido (solo para que la instalación continúe; se llenará con los datos reales después):

<?php
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base');
define('_DB_USER_', 'usuario_db');
define('_DB_PASSWD_', 'contraseña_db');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_ENGINE_', 'InnoDB');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_COOKIE_KEY_', 'genera_un_hash_largo');
define('_COOKIE_IV_', 'genera_otro_hash');
define('_PS_CREATION_DATE_', date('Y-m-d'));
if (!defined('_PS_VERSION_')) {
    define('_PS_VERSION_', '1.7.8.0');
}

[WARNING]

Este es un truco avanzado. Si no te sientes cómodo editando código, es mejor que borres la instalación y vuelvas a empezar desde cero con la subida de archivos. Un error aquí puede causar más problemas.

Error 4: "No se puede conectar a la base de datos"

Este error es claro: PrestaShop no puede comunicarse con MySQL. Es uno de los errores PrestaShop Plesk más fáciles de diagnosticar, pero también uno de los que más dolores de cabeza causa.

¿Cuál es el problema?

Datos de conexión incorrectos: El nombre de la base de datos, el usuario o la contraseña no coinciden con los que creaste en Plesk.
La base de datos no existe: A veces, se intenta instalar sin haber creado la base de datos previamente.
El usuario no tiene privilegios: El usuario de la base de datos no tiene permisos para acceder a la base de datos que estás usando.
Host de la base de datos incorrecto: A menudo es localhost, pero en algunos servidores Plesk puede ser un nombre de host específico (como mysql.yourdomain.com).

Solución en Plesk

Paso 1: Revisa tus credenciales en Plesk

Ve a la sección Bases de datos en tu panel de Plesk.
Anota el nombre exacto de la base de datos (suele tener un prefijo como tuusuario_).
Anota el nombre de usuario y contraseña que asignaste.
Asegúrate de que el host sea localhost (o el que te indique tu proveedor).

Paso 2: Verifica los privilegios del usuario

En la misma sección de Bases de datos, haz clic en el nombre de tu base de datos.
Busca la pestaña Usuarios o Privilegios.
Asegúrate de que tu usuario esté en la lista y tenga TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, edítalo y marca "Todos los privilegios".

Paso 3: Usa la herramienta de creación de bases de datos de Plesk

Si no has creado la base de datos, es el momento de hacerlo:

En Plesk, ve a Bases de datos -> Agregar base de datos.
Introduce un nombre (por ejemplo, prestashop_db).
Plesk creará automáticamente un usuario con una contraseña. Anota estos datos.
Usa estos datos exactos en el instalador de PrestaShop.

[TIP]

Plesk a menudo añade un prefijo al nombre de la base de datos y al usuario (por ejemplo, usuario_prestashop_db). Copia y pega los nombres directamente desde Plesk para evitar errores tipográficos.

Error 5: La tienda carga, pero la página de administración no (o viceversa)

Este es un problema más sutil. A veces la tienda se ve perfecta, pero al intentar acceder a /admin obtienes un error 404 o una página en blanco. O al revés.

La causa

URL de administración incorrecta: Durante la instalación, se genera una URL de administración aleatoria (como /admin12345). Si la has olvidado, no podrás acceder.
Problemas con la reescritura de URL (mod_rewrite): Si .htaccess no funciona correctamente, las URLs amigables fallan, y la tienda puede no cargar.
Cache corrupta: A veces, la caché de PrestaShop se bloquea y causa errores extraños.

Solución práctica

Paso 1: Encuentra tu URL de administración

Ve a Archivos en Plesk.
Navega a la raíz de tu instalación.
Busca una carpeta que empiece por admin (ej: admin12345). Esa es tu carpeta de administración.
Accede a tudominio.com/admin12345.

Paso 2: Limpia la caché manualmente

Ve a Archivos en Plesk.
Navega a la carpeta var/cache (en PrestaShop 1.7 y 8.x) o cache (en versiones antiguas).
Selecciona TODOS los archivos dentro de esa carpeta y bórralos (no borres la carpeta en sí).
Recarga tu tienda y tu panel de administración.

Paso 3: Desactiva la reescritura de URL temporalmente

En el administrador de archivos de Plesk, renombra el archivo .htaccess a .htaccess_bak.
Intenta cargar tu tienda. Si ahora funciona (aunque con URLs feas), el problema es la reescritura.
Ve a tu panel de administración (si puedes) -> Parámetros avanzados -> Rendimiento -> URLs amigables y desactívalas. Luego, guarda y reactívalas.
Si no puedes acceder al panel, vuelve a subir un .htaccess