🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solucionar errores comunes en PrestaShop al instalar

Actualizado el 9 de enero de 2026

Instalar PrestaShop puede parecer una tarea sencilla, pero a menudo aparecen pequeños obstáculos que pueden desanimar a cualquiera. Ver una pantalla en blanco, un error de conexión a la base de datos o un mensaje de “500 Internal Server Error” justo cuando estás a punto de lanzar tu tienda online puede ser frustrante. No te preocupes: soy tu técnico de soporte amigable y voy a guiarte paso a paso para solucionar los errores más comunes en PrestaShop al instalarlo.

Este artículo está pensado para que, incluso si no eres un experto en hosting, puedas resolver estos problemas por ti mismo. Vamos a cubrir desde errores de permisos hasta conflictos con la versión de PHP, pasando por problemas típicos de configuración del servidor. Al final, tendrás una guía práctica que podrás usar como referencia siempre que lo necesites.

Errores de permisos de archivos y carpetas

Uno de los problemas más frecuentes al instalar PrestaShop son los errores relacionados con los permisos de archivos y carpetas. PrestaShop necesita poder escribir en ciertos directorios para crear archivos de configuración, imágenes de productos, plantillas y módulos.

Síntomas típicos

  • El instalador se queda atascado en un paso y no avanza.
  • Aparece un mensaje que dice: “No se puede escribir en la carpeta /config” o “Permiso denegado”.
  • Después de la instalación, ves una pantalla en blanco o errores al intentar acceder al panel de administración.

Solución paso a paso

  1. Accede a tu panel de control de hosting. Si usas Syspanel (antes conocido como HestiaCP), recuerda que el acceso es a través del puerto 2106 (ejemplo: https://tudominio.com:2106).
  2. Busca la sección de “Administrador de archivos” o utiliza un cliente FTP (como FileZilla).
  3. Navega hasta la carpeta raíz donde has subido los archivos de PrestaShop (normalmente public_html o www).
  4. Selecciona todas las carpetas y archivos de PrestaShop (puedes usar Ctrl+A).
  5. Cambia los permisos a 755 para las carpetas y 644 para los archivos. En la mayoría de los paneles, esto se hace con un clic derecho > “Permisos” o “Propiedades”.
  6. Presta especial atención a estas carpetas que deben tener permisos 777 (o al menos 755 si tu hosting es más restrictivo):
    • /config
    • /cache
    • /log
    • /img
    • /mails
    • /modules
    • /themes
    • /translations
    • /upload
    • /download

[TIP] Si después de cambiar los permisos sigues teniendo problemas, contacta con tu proveedor de hosting. A veces tienen configuraciones de seguridad adicionales (como “PHP suExec” o “mod_security”) que bloquean la escritura. Ellos pueden ajustarlo por ti.

Errores de conexión a la base de datos

Otro clásico: el instalador te pide los datos de tu base de datos y, aunque estés seguro de haberlos escrito bien, te muestra un error como “No se puede conectar a la base de datos” o “El usuario no tiene permisos”.

Causas más comunes

  • El nombre de la base de datos, el usuario o la contraseña son incorrectos.
  • El usuario de la base de datos no está vinculado a la base de datos.
  • El servidor de base de datos no es accesible (por ejemplo, el host no es “localhost” sino una IP remota).

Cómo solucionarlo

  1. Verifica los datos en tu panel de control. En Syspanel, ve a la sección “Base de Datos” (o “Databases”). Allí verás el nombre exacto de tu base de datos y el usuario asociado.
  2. Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. Normalmente, al crear la base de datos, el panel te permite marcar “Todos los privilegios” o “Grant all privileges”. Si no lo hiciste, puedes editar el usuario y asignarlos.
  3. Comprueba el nombre del servidor. En el 99% de los casos, el servidor de base de datos es localhost. Sin embargo, algunos hosts usan algo como mysql.tudominio.com o una IP. Si no estás seguro, consulta la documentación de tu hosting o el propio panel.
  4. Prueba la conexión manualmente con una herramienta como phpMyAdmin (suele venir incluida en Syspanel). Si puedes acceder con esos datos desde phpMyAdmin, el problema está en otro lado.
  5. Revisa que no haya comillas o espacios extra al copiar y pegar las credenciales. A veces, sin querer, copiamos un espacio al final.

[WARNING] Nunca uses los datos de acceso de la base de datos principal de tu hosting (la que usas para el panel de control). Crea siempre una base de datos y un usuario específicos para PrestaShop.

Problemas con la versión de PHP

PrestaShop es exigente con la versión de PHP. Si tu servidor usa una versión demasiado antigua o demasiado nueva, la instalación fallará o la tienda no funcionará correctamente.

Versiones recomendadas

  • PrestaShop 1.7 (la más común hoy en día): requiere PHP 7.1 a 7.4. PHP 8.0 puede funcionar, pero no está totalmente soportado y puede dar errores en módulos.
  • PrestaShop 8.x: ya es compatible con PHP 8.0 y 8.1, pero siempre es mejor consultar los requisitos exactos en la documentación oficial.

Cómo cambiar la versión de PHP

  1. Accede a Syspanel (puerto 2106).
  2. Busca la opción “PHP Settings” o “Versión de PHP” (puede estar dentro de “Web” o “Advanced Settings”).
  3. Selecciona la versión adecuada para tu PrestaShop (por ejemplo, 7.4).
  4. Guarda los cambios. El cambio es inmediato, aunque a veces tarda unos segundos en aplicarse.

[INFO] Si tu hosting no te permite cambiar la versión de PHP fácilmente, contacta con soporte. Muchos proveedores lo ofrecen de forma gratuita. Si usas un hosting compartido muy básico, quizá tengas que migrar a uno que sí lo permita.

Errores de memoria PHP (memory limit)

Al instalar PrestaShop, especialmente si tienes muchos módulos o un tema pesado, puede aparecer un error como “Fatal error: Allowed memory size of 134217728 bytes exhausted”. Esto significa que PHP no tiene suficiente memoria para completar la instalación.

Solución

  1. Aumenta el límite de memoria de PHP. En Syspanel, dentro de “PHP Settings”, busca el parámetro memory_limit y cámbialo a 256M o incluso 512M.
  2. Si no tienes acceso a esa opción, puedes intentar crear un archivo php.ini en la raíz de tu PrestaShop con el siguiente contenido: 
    memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M
  3. Otra opción es modificar el archivo .htaccess (si existe) o crearlo y añadir: 
    php_value memory_limit 256M
php_value max_execution_time 300

[TIP] Si después de hacer esto el error persiste, es posible que tu hosting tenga restricciones a nivel de servidor. Pregunta a soporte si pueden aumentarlo temporalmente para la instalación.

Error 500 o pantalla en blanco después de la instalación

Este es uno de los errores más desesperantes. Has seguido todos los pasos, la instalación parece completarse, pero al intentar acceder a tu tienda o al panel de administración, solo ves una pantalla en blanco o un “500 Internal Server Error”.

Causas frecuentes

  • Archivos corruptos durante la subida.
  • Permisos incorrectos (ya lo vimos).
  • Errores en el archivo settings.inc.php (en PrestaShop 1.7 se llama parameters.php).
  • Conflictos con módulos o temas precargados.

Pasos para diagnosticar y solucionar

  1. Activa el modo debug de PrestaShop. Para ello, edita el archivo /config/defines.inc.php y busca la línea:

    define('_PS_MODE_DEV_', false);

    Cámbiala a:

    define('_PS_MODE_DEV_', true);

    Esto mostrará los errores detallados en lugar de la pantalla en blanco.

  2. Revisa el error que aparece. Por ejemplo, si dice “Class ‘Module’ not found”, puede que falte un archivo o que la carpeta /modules no tenga permisos.

  3. Vuelve a subir los archivos de PrestaShop. A veces, durante la subida por FTP, algún archivo se corrompe. Descarga el paquete oficial desde prestashop.com y súbelo de nuevo, preferiblemente usando un cliente FTP que verifique la integridad.

  4. Comprueba el archivo parameters.php (o settings.inc.php en versiones antiguas). Debe contener los datos correctos de la base de datos y la URL de tu tienda. Si ves algo raro, puedes regenerarlo eliminando el archivo y volviendo a ejecutar el instalador (pero perderás la configuración).

  5. Desactiva temporalmente los módulos no esenciales. Si puedes acceder al panel de administración (aunque sea con errores), ve a “Módulos” y desactiva todos excepto los que vienen por defecto. Luego ve activándolos uno por uno para encontrar el culpable.

[WARNING] Si modificas archivos como defines.inc.php, asegúrate de volver a cambiar _PS_MODE_DEV_ a false cuando termines de depurar. Dejarlo en true en un sitio en producción muestra información sensible a los visitantes.

Errores relacionados con la URL de la tienda

Al instalar PrestaShop, te pide que introduzcas la URL de tu tienda. Si cometes un error aquí, la tienda no cargará correctamente o los enlaces estarán rotos.

Problema típico

  • La tienda se ve bien, pero al hacer clic en cualquier enlace, aparece un error 404.
  • Las imágenes no se muestran.
  • El panel de administración redirige a una URL incorrecta.

Solución

  1. Accede a la base de datos usando phpMyAdmin (desde Syspanel).
  2. Busca la tabla ps_configuration (o ps_shop_url si tu PrestaShop es más moderno).
  3. Localiza las filas con los nombres PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL (si usas HTTPS).
  4. Edítalas y asegúrate de que contengan tu dominio correcto, sin http:// ni https://. Por ejemplo: mitienda.com.
  5. En la tabla ps_shop_url, verifica que el campo domain y domain_ssl también estén correctos.

[TIP] Si cambiaste de dominio después de instalar PrestaShop, también debes actualizar estas entradas. Además, recuerda regenerar el archivo .htaccess desde el panel de administración: “Parámetros de la tienda” > “Tráfico y SEO” > “SEO y URLs” y haz clic en “Guardar” (esto regenera el archivo).

Errores al instalar desde el asistente web (el famoso “1-click install”)

Muchos paneles de hosting ofrecen instaladores automáticos (Softaculous, Installatron, etc.). Aunque son cómodos, a veces fallan.

Problemas comunes

  • El instalador se queda colgado en “Instalando...”.
  • Crea la base de datos pero no los archivos.
  • La instalación parece exitosa pero la tienda no funciona.

Qué hacer

  1. Espera unos minutos. A veces el proceso tarda más de lo normal.
  2. Revisa los registros de errores del servidor. En Syspanel, busca “Logs” o “Error Log”. Allí verás si hay algún problema de permisos o de memoria.
  3. Si falla, intenta la instalación manual. Descarga el paquete de PrestaShop, súbelo por FTP y sigue el asistente manualmente. Es más controlable y suele resolver estos problemas.
  4. Asegúrate de que el instalador automático use la versión correcta de PHP. Algunos paneles permiten seleccionar la versión antes de instalar.

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

Aquí tienes las dudas más habituales que resolvemos en soporte técnico.

¿Por qué aparece “500 Internal Server Error” justo después de subir los archivos?

Esto suele deberse a un archivo .htaccess incorrecto o a permisos inadecuados. Prueba a renombrar temporalmente el .htaccess a .htaccess_old y vuelve a cargar la página. Si funciona, el problema está en ese archivo. También verifica los permisos de la carpeta raíz (deben ser 755).

¿Puedo instalar PrestaShop en un subdirectorio (ej: midominio.com/tienda)?

Sí, pero ten cuidado con las URLs. Durante la instalación, cuando te pregunte por la URL de la tienda, asegúrate de incluir la subcarpeta: https://midominio.com/tienda. Después, en la base de datos, las tablas ps_shop_url deben reflejar esa ruta.

¿Qué hago si el instalador no me deja avanzar del paso de “Compatibilidad del sistema”?

Revisa los requisitos que aparecen en rojo. Normalmente son extensiones de PHP que faltan (como mysqli, gd, curl, zip, etc.). En Syspanel, dentro de “PHP Settings”, puedes ver las extensiones activadas. Si falta alguna, contacta con soporte para que la activen.

Después de instalar, solo veo la página de “Bienvenido a PrestaShop” pero no puedo acceder al panel de administración

Esto ocurre cuando la instalación no se completó del todo. Vuelve a ejecutar el instalador desde cero (elimina la base de datos y los archivos, y súbelos de nuevo). Asegúrate de que el proceso termine sin errores y de que veas el mensaje de “Instalación completada”.

Mi hosting usa Syspanel (puerto 2106). ¿Hay algún ajuste especial que deba hacer?

Syspanel es un panel muy completo y suele funcionar bien con PrestaShop. Solo asegúrate de:

  • Tener la versión de PHP correcta (7.4 para PrestaShop 1.7).
  • Habilitar las extensiones necesarias (mysqli, gd, curl, etc.) desde la sección “PHP Settings”.
  • Usar las credenciales de la base de datos que creaste específicamente para PrestaShop.
  • Si tienes problemas de permisos, recuerda que Syspanel usa un usuario de sistema. A veces necesitas cambiar el propietario de los archivos a ese usuario (puedes hacerlo desde el administrador de archivos o con comandos SSH si tienes acceso).

[INFO] Si después de seguir todos estos pasos sigues teniendo problemas, no dudes en abrir un ticket de soporte con tu proveedor de hosting. Diles exactamente qué error ves (mejor si activas el modo debug) y qué pasos has intentado. Así te ayudarán mucho más rápido.

Conclusión

Instalar PrestaShop no tiene por qué ser una pesadilla. La mayoría de los errores comunes tienen soluciones sencillas que puedes aplicar tú mismo sin necesidad de ser un experto. Recuerda siempre:

  • Verificar los permisos de archivos y carpetas.
  • Usar la versión correcta de PHP.
  • Asegurarte de que los datos de la base de datos son exactos.
  • Activar el modo debug para ver errores ocultos.

Con esta guía, espero que puedas superar cualquier obstáculo y lanzar tu tienda online con éxito. Si te encuentras con un error que no está en esta lista, no te desanimes: busca en foros, en la documentación oficial o consulta a tu hosting. La comunidad de PrestaShop es muy activa y siempre hay alguien dispuesto a ayudar.

¡Buena suerte con tu tienda!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel