Errores comunes al instalar PrestaShop y cómo solucionarlos

Instalar PrestaShop es el primer paso para montar tu tienda online, pero a veces pueden aparecer algunos errores que frenan el proceso. No te preocupes, es algo normal. En esta guía extensa te explicamos los problemas más frecuentes y, lo más importante, cómo solucionarlos paso a paso. Vamos a convertir ese "error" en un "todo listo".

1. Error de "No se puede conectar a la base de datos"

Este es, con diferencia, el error más habitual durante la instalación de PrestaShop. Aparece cuando el sistema no logra comunicarse con tu base de datos MySQL.

¿Por qué ocurre?

Los datos de acceso (usuario, contraseña, nombre de la base de datos) son incorrectos.
El servidor MySQL no está en ejecución.
El usuario de la base de datos no tiene permisos suficientes.
El nombre del servidor de base de datos (host) es incorrecto. Normalmente es localhost, pero en algunos alojamientos puede ser diferente.

Solución paso a paso

Verifica los datos de acceso: Asegúrate de que el usuario, la contraseña y el nombre de la base de datos son exactamente los que creaste. Revisa mayúsculas, minúsculas y caracteres especiales.
Comprueba el host de la base de datos: En la mayoría de los casos es localhost. Si tu hosting usa un servidor separado, te proporcionarán una dirección como mysql.tudominio.com. Consulta el panel de control de tu hosting.
Revisa los permisos del usuario: Desde tu panel de control (por ejemplo, cPanel, Syspanel o phpMyAdmin), asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. En Syspanel (accesible por puerto 2106), ve a "Base de datos" y selecciona "Gestionar permisos".
Prueba la conexión manualmente: Usa una herramienta como phpMyAdmin o la línea de comandos para conectarte con esos mismos datos. Si falla, el problema está en la configuración del servidor.

[TIP] Si usas Syspanel, recuerda que la base de datos se crea desde el panel y el nombre suele ser usuario_nombrebasedatos. El host casi siempre es localhost.

2. Pantalla en blanco o error 500 durante la instalación

Una pantalla completamente blanca (también llamada "White Screen of Death") o un error HTTP 500 suele indicar un problema con los archivos de PrestaShop o con la configuración del servidor.

Causas comunes

Archivos de instalación corruptos o incompletos.
Permisos de archivos incorrectos.
Límite de memoria de PHP insuficiente.
Versión de PHP no compatible.

Solución paso a paso

Vuelve a descargar PrestaShop: Descarga la última versión estable desde el sitio oficial y súbela de nuevo a tu servidor. Asegúrate de que la subida sea completa (puedes usar FTP o el gestor de archivos de Syspanel).
Ajusta los permisos de archivos: Los archivos deben tener permiso 644 y las carpetas 755. En Syspanel, puedes hacerlo desde el "Administrador de archivos" seleccionando todo y dando clic en "Permisos".
Aumenta el límite de memoria PHP: En tu archivo php.ini o desde el panel de control, cambia memory_limit a 256M o más. En Syspanel, ve a "Configuración de PHP" y modifica el valor.
Verifica la versión de PHP: PrestaShop 8 requiere PHP 7.4 o superior (recomendado PHP 8.0 o 8.1). Desde Syspanel (puerto 2106) puedes cambiar la versión de PHP en "Ajustes del servidor" > "Versión de PHP".

[WARNING] No uses PHP 8.2 o superior si no has verificado la compatibilidad con tu versión de PrestaShop. Algunos módulos pueden fallar.

3. Error "El directorio de instalación no tiene permisos de escritura"

Durante la instalación, PrestaShop necesita escribir archivos temporales y de configuración. Si el sistema no puede hacerlo, te mostrará este error.

¿Por qué ocurre?

El usuario del servidor web (por ejemplo, www-data) no tiene permisos de escritura en la carpeta de PrestaShop.
El propietario de los archivos no es el correcto.

Solución paso a paso

Cambia el propietario de los archivos: Si tienes acceso SSH, ejecuta chown -R usuario:grupo /ruta/a/prestashop. En Syspanel, puedes usar el "Gestor de archivos" para seleccionar la carpeta y asignar el propietario adecuado (normalmente el usuario de tu hosting).
Da permisos de escritura a las carpetas necesarias: Las carpetas config, cache, log, img, mails, modules, themes, translations, upload, download, sitemap.xml y app/config deben tener permisos 755 o 777 temporalmente. Después de la instalación, puedes reducirlos a 755.
Desactiva el modo seguro (safe mode): Si tu servidor tiene el modo seguro activado, puede bloquear la escritura. Pide a tu proveedor que lo desactive.

[INFO] Una vez finalizada la instalación, es buena práctica volver a poner permisos 755 en las carpetas y 644 en los archivos para mayor seguridad.

4. Error de "Tiempo de ejecución excedido" (Timeout)

La instalación se queda colgada o muestra un error de tiempo de espera agotado. Esto suele pasar en servidores compartidos o con recursos limitados.

Causas

El servidor tiene un límite de tiempo de ejecución muy bajo.
Hay demasiados procesos ejecutándose al mismo tiempo.
La conexión a internet es lenta y la subida de archivos se interrumpe.

Solución paso a paso

Aumenta el tiempo de ejecución de PHP: En tu php.ini, cambia max_execution_time a 300 (5 minutos). En Syspanel, puedes hacerlo desde "Configuración de PHP".
Aumenta el tiempo de espera del servidor web: Si usas Apache, puedes agregar TimeOut 300 en el archivo de configuración. En Syspanel, esto se gestiona desde "Ajustes del servidor".
Realiza la instalación en modo CLI: Si tienes acceso SSH, puedes ejecutar la instalación desde la línea de comandos para evitar límites de tiempo del navegador. El comando sería algo como: php install/index_cli.php --domain= tudominio.com --db_server=localhost --db_user=usuario --db_password=contraseña --db_name=basedatos.
Divide la instalación: Algunos errores de timeout ocurren al importar la base de datos. Puedes importarla manualmente desde phpMyAdmin o Syspanel (en "Base de datos" > "Importar") y luego continuar la instalación.

5. Error de "Versión de PHP no compatible"

PrestaShop te informa que la versión de PHP de tu servidor no es la adecuada.

¿Qué hacer?

Actualiza PHP: La mayoría de los paneles de control permiten cambiar la versión de PHP fácilmente. En Syspanel (puerto 2106), ve a "Ajustes del servidor" > "Versión de PHP" y selecciona una versión compatible (7.4, 8.0 u 8.1).
Verifica los requisitos: PrestaShop 8 necesita PHP 7.4 como mínimo. Si tu servidor solo ofrece versiones anteriores, deberás contactar con tu proveedor de hosting.
Comprueba las extensiones: Además de la versión, PrestaShop requiere extensiones como PDO, MySQLi, GD, cURL, JSON, XML, Zip, etc. Desde Syspanel puedes ver las extensiones activas en "Configuración de PHP".

[TIP] Si tu hosting usa Syspanel, el cambio de versión de PHP es inmediato y no requiere reiniciar el servidor.

6. Error "No se puede crear el archivo de configuración"

PrestaShop no puede generar el archivo settings.inc.php (en versiones antiguas) o los archivos de configuración en la carpeta app/config.

Causas

Permisos insuficientes en la carpeta config o app/config.
El archivo ya existe y está protegido contra escritura.

Solución

Crea el archivo manualmente: Durante la instalación, PrestaShop te mostrará el contenido del archivo de configuración. Cópialo, crea un archivo vacío y pégalo. Luego súbelo a la carpeta correspondiente con permisos 644.
Borra archivos previos: Si ya intentaste instalar antes, elimina cualquier archivo de configuración antiguo (como settings.inc.php o archivos en app/config/) y vuelve a intentarlo.
Ajusta permisos temporalmente: Da permisos 777 a la carpeta config (o app/config) durante la instalación y luego restáuralos a 755.

7. Error de "URL de la tienda incorrecta" o "Redireccionamiento infinito"

Después de instalar, al acceder a tu tienda, te redirige una y otra vez o muestra una URL incorrecta.

Causas

La URL de la tienda no se configuró correctamente durante la instalación.
El archivo .htaccess no se generó bien.
Hay un conflicto con la caché del navegador.

Solución paso a paso

Limpia la caché del navegador y de PrestaShop: Desde el back office (si puedes acceder) ve a "Parámetros avanzados" > "Rendimiento" y limpia la caché. Si no puedes acceder, borra manualmente la carpeta var/cache/ (en PrestaShop 8 es var/cache/prod/).
Regenera el archivo .htaccess: Desde el back office, ve a "Parámetros avanzados" > "SEO y URLs" y haz clic en "Guardar" para regenerar el archivo.
Verifica la URL en la base de datos: Si no puedes acceder al back office, conecta a tu base de datos (phpMyAdmin o Syspanel) y en la tabla ps_configuration busca las variables PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL. Asegúrate de que tengan tu dominio correcto (sin http:// ni www a menos que sea necesario).

[WARNING] No uses localhost como dominio en producción. Siempre usa tu dominio real.

8. Error de "Módulo no encontrado" o "Clase no encontrada"

Al intentar acceder al back office o instalar un módulo, aparece un error de clase faltante.

Causas

La instalación no se completó correctamente.
Faltan archivos del núcleo de PrestaShop.
La versión de PHP no es compatible con algún módulo.

Solución

Reinstala PrestaShop: A veces la solución más rápida es borrar todo y volver a subir los archivos limpios. No olvides hacer una copia de la base de datos si ya tienes datos.
Verifica la integridad de los archivos: Compara los archivos de tu servidor con los de la descarga oficial. Puedes usar la función "Verificar integridad" de algunos módulos de seguridad.
Actualiza los módulos: Si el error ocurre con un módulo específico, desactívalo desde la base de datos (tabla ps_module) y luego actualízalo a la última versión.

9. Error "No se puede conectar al servicio de correo"

PrestaShop necesita enviar correos (confirmaciones de pedido, recuperación de contraseñas, etc.). Si no configura el envío de correos, pueden aparecer errores.

Solución

Configura SMTP: En el back office, ve a "Parámetros avanzados" > "Correo electrónico". Selecciona "Usar SMTP" e introduce los datos de tu servidor de correo (servidor, puerto, usuario, contraseña, cifrado).
Prueba el envío: Usa la opción "Enviar un correo de prueba" para verificar que todo funciona.
Revisa los logs: Si los correos no se envían, revisa los logs de error de PrestaShop (en var/logs/) o los logs del servidor.

[TIP] Si usas Syspanel, puedes crear cuentas de correo desde "Correo electrónico" y usar esos mismos datos para SMTP.

10. Error "La tienda está en modo mantenimiento"

Después de instalar, al acceder a la tienda ves un mensaje de "tienda en mantenimiento".

Causas

Durante la instalación, PrestaShop activa el modo mantenimiento por defecto.
No has completado la instalación o has cancelado el proceso a mitad.

Solución

Accede al back office: Ve a tudominio.com/adminXXXX (donde XXXX es el código que se te dio durante la instalación).
Desactiva el modo mantenimiento: En "Parámetros de la tienda" > "Mantenimiento", desmarca la opción "Activar tienda en modo mantenimiento".
Si no puedes acceder al back office: Conéctate a la base de datos y en la tabla ps_configuration busca PS_SHOP_ENABLE y cámbiala a 1.

Preguntas Frecuentes (FAQ)

¿Cuánto tiempo tarda la instalación de PrestaShop?

Normalmente entre 5 y 15 minutos, dependiendo de la velocidad de tu servidor y de tu conexión. Si tarda más, revisa los tiempos de ejecución.

¿Puedo instalar PrestaShop en un servidor local (XAMPP, WAMP)?

Sí, es perfecto para pruebas. Solo asegúrate de tener PHP 7.4+ y las extensiones necesarias. Luego, para producción, migra a un hosting real.

¿Qué hago si olvido la contraseña del back office?

Puedes restablecerla desde la base de datos: en la tabla ps_employee, cambia el campo passwd por un hash generado con la herramienta "Password Hash Generator" de PrestaShop.

¿Es necesario tener conocimientos técnicos para instalar PrestaShop?

No, pero ayuda saber lo básico de FTP, bases de datos y paneles de control. Si usas Syspanel (puerto 2106), la instalación es aún más guiada.

¿Puedo instalar PrestaShop en un hosting compartido?

Sí, siempre que cumpla con los requisitos mínimos (PHP 7.4+, MySQL 5.6+, al menos 256 MB de memoria PHP).

Conclusión

Instalar PrestaShop puede parecer un desafío, pero la mayoría de los errores tienen solución. Recuerda siempre verificar los permisos, la versión de PHP y los datos de conexión a la base de datos. Si usas un panel como Syspanel (accesible por puerto 2106), muchas de estas configuraciones están a un clic de distancia.

No te desanimes si algo sale mal. Cada error es una oportunidad para aprender más sobre cómo funciona tu tienda online. Y si después de seguir esta guía sigues teniendo problemas, contacta con tu proveedor de hosting: ellos pueden ayudarte a revisar la configuración del servidor.

[INFO] Guarda esta guía en tus favoritos. Cada vez que instales PrestaShop, repásala y verás que cada vez te resultará más fácil.

¡Buena suerte con tu tienda online!