Solucionar error de instalación de PrestaShop: pantalla en blanco y más

¿Por qué PrestaShop no se instala o muestra una pantalla en blanco?

Si estás intentando montar tu tienda online y te encuentras con el error "PrestaShop no se instala" o ves una pantalla en blanco, no te preocupes. Es uno de los problemas más comunes al empezar con esta plataforma, y en la mayoría de los casos tiene una solución sencilla.

Antes de que te agobies pensando que has roto algo, respira. Este tipo de fallos suelen estar relacionados con la configuración del servidor, los permisos de archivos o la memoria disponible. A lo largo de esta guía, vamos a desgranar paso a paso las causas más habituales y cómo solucionarlas, pensando en personas sin experiencia técnica.

Primeros pasos: entender el error de instalación de PrestaShop

Cuando hablamos de "PrestaShop no se instala", nos referimos a que el proceso de instalación se queda bloqueado, no avanza o directamente no arranca. En otros casos, el problema es una "pantalla en blanco", que técnicamente se llama "error 500" o "página en blanco". Esto significa que el servidor está ejecutando el código pero no puede mostrarlo, casi siempre por un conflicto de configuración.

Vamos a ir por partes, porque la solución depende de en qué punto exacto te falla. No es lo mismo que no cargue el instalador a que falle a mitad del proceso.

Comprueba los requisitos mínimos del servidor

Lo primero que debes verificar es que tu hosting cumple con los requisitos mínimos de PrestaShop. Si tu plan es muy básico, es probable que el instalador no funcione correctamente.

Esto es lo que necesita PrestaShop 8 (la versión más reciente):

PHP 7.2.5 o superior (te recomendamos PHP 8.0 o 8.1 para mejor rendimiento).
MySQL 5.6 o superior (o MariaDB 10.1+).
Espacio en disco: al menos 500 MB libres.
Memoria PHP: mínimo 128 MB, idealmente 256 MB.

Si no sabes qué versión de PHP tienes, puedes verlo desde el panel de control de tu hosting. Si usas Syspanel, recuerda que el acceso es a través del puerto 2106. Ahí podrás cambiar la versión de PHP en la sección "Administrador de archivos" o "Configuración de PHP".

[INFO] La mayoría de los problemas de instalación se resuelven simplemente activando una versión de PHP más moderna desde el panel de control.

Solucionar el error "PrestaShop no se instala" por falta de permisos

Una causa muy frecuente de que PrestaShop no se instale es que los archivos no tengan los permisos correctos. Durante la instalación, el script necesita escribir archivos de configuración y crear carpetas temporales. Si no tiene permisos, se detiene en seco.

Cómo solucionar los permisos en Linux/hosting compartido

Si tienes acceso a un administrador de archivos (como el de Syspanel o cPanel), sigue estos pasos:

Abre el administrador de archivos de tu hosting.
Navega hasta la carpeta raíz donde has subido PrestaShop (normalmente public_html o www).
Selecciona todos los archivos y carpetas de PrestaShop.
Busca la opción "Permisos" o "Chmod".
Establece el valor en 755 para carpetas y 644 para archivos.

El problema es que hacer esto archivo por archivo es un coñazo. La forma más rápida es usar un cliente FTP como FileZilla y aplicar los permisos de forma recursiva. Pero si no tienes experiencia con FTP, el administrador de archivos de tu hosting suele tener una opción para aplicar permisos a todo el contenido de una carpeta de golpe.

[WARNING] No pongas permisos 777 en producción nunca. Es un riesgo de seguridad grave. Usa 755/644 como máximo.

Permisos en servidores con Syspanel

Si tu hosting usa Syspanel, el procedimiento es similar. Entra por el puerto 2106, ve a "Archivos" y busca la carpeta de tu dominio. Ahí podrás cambiar los permisos de forma visual, seleccionando las carpetas y marcando las casillas de lectura, escritura y ejecución.

Pantalla en blanco en PrestaShop: cómo diagnosticarla

La dichosa pantalla en blanco es el error más odiado por los usuarios de PrestaShop. Puede aparecer al intentar instalar o después de una actualización. La buena noticia es que casi siempre viene acompañada de un mensaje de error oculto que podemos sacar a la luz.

Activa el modo de depuración de PrestaShop

PrestaShop tiene un modo de depuración que muestra los errores en lugar de la pantalla en blanco. Para activarlo, tienes que editar un archivo llamado config/defines.inc.php.

Aquí tienes los pasos:

Conéctate a tu hosting por FTP o con el administrador de archivos.
Busca la carpeta config dentro de la instalación de PrestaShop.
Edita el archivo defines.inc.php con un editor de texto (nunca con el bloc de notas de Windows, usa algo como Notepad++ o el editor del panel).
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala por define('_PS_MODE_DEV_', true);.
Guarda los cambios y sube el archivo de nuevo si lo has editado localmente.

Ahora recarga la página. En lugar de la pantalla en blanco, verás un mensaje de error concreto, como "Fatal error: Allowed memory size...". Ese mensaje es oro puro para saber qué está fallando.

[TIP] Cuando termines de diagnosticar, vuelve a poner false para no mostrar errores a tus clientes en producción.

Errores comunes que muestra el modo depuración

"Allowed memory size exhausted": Necesitas aumentar la memoria PHP.
"Class not found": Archivos corruptos o incompletos. Re-subir los archivos.
"Database connection failed": Los datos de conexión a la base de datos son incorrectos.

Aumentar la memoria PHP para evitar la pantalla en blanco

Este es el error más común de todos. PrestaShop es una plataforma que consume mucha memoria, especialmente durante la instalación. Si tu servidor tiene un límite bajo, se queda a medias.

Cómo aumentar la memoria en el archivo php.ini

Si tienes acceso al archivo php.ini de tu hosting:

Busca la línea memory_limit.
Cámbiala a memory_limit = 256M o incluso 512M si tienes un plan potente.
Guarda y reinicia el servicio PHP si es necesario.

Cómo aumentarla desde Syspanel

Si usas Syspanel, no necesitas tocar archivos. Entra por el puerto 2106, ve a la sección de "PHP" o "Configuración de PHP" y busca el parámetro memory_limit. Ahí puedes aumentarlo con un simple selector o escribiendo el valor manualmente.

[INFO] Si tu hosting no te permite editar php.ini, puedes crear un archivo llamado php.ini en la carpeta raíz de PrestaShop con el contenido: memory_limit = 256M. A veces funciona.

Aumentar memoria con un archivo .htaccess

Otra opción es añadir esta línea al archivo .htaccess en la raíz de PrestaShop:

php_value memory_limit 256M

Pero esto solo funciona si tu servidor Apache tiene mod_php activado. En muchos hostings modernos, no hace nada.

Problemas con la base de datos durante la instalación

Otro clásico es que PrestaShop no se instala porque no puede conectar con la base de datos. Esto suele pasar por errores al escribir el nombre de la base, el usuario o la contraseña.

Comprueba los datos de la base de datos

Nombre de la base de datos: Debe ser exacto, incluyendo el prefijo que te da tu hosting (por ejemplo, usuario_bd_prestashop).
Usuario de la base: Igual, con el prefijo completo.
Contraseña: Ojo con las mayúsculas y caracteres especiales.

Crea una base de datos desde Syspanel

Si no tienes base de datos creada, puedes hacerla desde Syspanel (puerto 2106). Busca la sección "Bases de datos" o "MySQL" y crea una nueva. Anota los datos porque los necesitarás en el instalador.

[WARNING] No uses los datos de acceso de tu panel de control como usuario de la base de datos. Debes crear un usuario específico para la base de datos de PrestaShop.

Archivos corruptos o incompletos: la causa silenciosa

A veces, PrestaShop no se instala porque los archivos que subiste al servidor están incompletos o se corrompieron durante la subida. Esto es más común de lo que parece, especialmente si usas un FTP con conexiones inestables.

Cómo saber si los archivos están corruptos

El instalador no arranca: La página se queda en blanco al acceder a tudominio.com/install.
Errores de clases no encontradas: El modo depuración muestra errores como "Class 'PrestaShopAutoload' not found".
La instalación se detiene a mitad: Se queda en el paso 2 o 3 sin avanzar.

Solución: subir los archivos de nuevo

La solución es tediosa pero efectiva:

Descarga el paquete de instalación desde el sitio oficial de PrestaShop.
Descomprime el ZIP en tu ordenador.
Borra TODOS los archivos de la carpeta donde quieres instalar PrestaShop (en el servidor).
Sube los archivos de nuevo con FileZilla o el administrador de archivos de tu hosting.

Asegúrate de que la subida sea completa. Si usas FileZilla, mira la cola de transferencias y verifica que no haya errores.

[TIP] Si el hosting tiene un instalador automático (como Softaculous o el de Syspanel), úsalo. Es mucho más fiable que subir archivos manualmente.

El error "PrestaShop no se instala" por incompatibilidad de versiones

Otro motivo frecuente es que la versión de PHP no sea compatible con la versión de PrestaShop que estás intentando instalar. Por ejemplo, PrestaShop 1.6 no funciona bien con PHP 8, y PrestaShop 8 no funciona con PHP 5.

Versiones recomendadas

PrestaShop 1.6: PHP 5.6 o 7.0 (como máximo).
PrestaShop 1.7: PHP 7.1 a 7.4.
PrestaShop 8: PHP 7.2 a 8.1.

Si tu hosting tiene una versión de PHP más moderna y estás instalando una versión antigua de PrestaShop, tendrás problemas. La solución es cambiar la versión de PHP desde el panel de control.

Cómo cambiar la versión de PHP en Syspanel

Entra en Syspanel a través del puerto 2106, busca "Configuración de PHP" o "Versión de PHP" y selecciona la que necesites. Guarda los cambios y prueba de nuevo la instalación.

Preguntas frecuentes sobre errores de instalación de PrestaShop

Aquí tienes las dudas más comunes que nos llegan al soporte, con sus respuestas rápidas.

¿Puedo instalar PrestaShop en un hosting gratuito?

Técnicamente sí, pero no lo recomendamos. Los hostings gratuitos suelen tener límites de memoria muy bajos, lo que provoca pantallas en blanco y fallos de instalación. Además, la velocidad será pésima.

¿Qué hago si veo "Error 500" en lugar de la pantalla de instalación?

Un error 500 es un error genérico del servidor. Activa el modo depuración como te hemos explicado antes para ver el mensaje real. Si no puedes, revisa los permisos de archivos y la memoria PHP.

¿Es normal que la instalación tarde varios minutos?

Sí, la instalación de PrestaShop puede tardar 2-5 minutos dependiendo del servidor. No cierres la pestaña del navegador ni recargues la página durante el proceso.

¿Puedo instalar PrestaShop en un subdominio?

Claro. Solo asegúrate de que la carpeta del subdominio esté vacía y de que los datos de la base de datos sean correctos. El proceso es idéntico.

¿Qué hago si la instalación se queda en el paso 3 (información de la tienda)?

Este paso requiere que rellenes todos los campos obligatorios. Si se queda cargando, revisa la memoria PHP y los permisos de la carpeta config. También puede ser un problema con el archivo settings.inc.php que no se puede escribir.

Resumen: checklist para solucionar errores de instalación

Para que no te pierdas, aquí tienes la lista de verificación definitiva:

Verifica los requisitos de PHP y MySQL en tu hosting.
Aumenta la memoria PHP a 256M como mínimo.
Comprueba los permisos de archivos y carpetas (755/644).
Revisa los datos de la base de datos (nombre, usuario, contraseña).
Activa el modo depuración para ver el error real.
Vuelve a subir los archivos si el modo depuración muestra errores de clases o archivos.
Cambia la versión de PHP si es incompatible con tu PrestaShop.
Usa el instalador automático de tu hosting si está disponible.

Con esto deberías poder resolver el error "PrestaShop no se instala" o la pantalla en blanco en el 95% de los casos. Si aun así no funciona, revisa los logs de error del servidor (en Syspanel, sección "Registros") o contacta con el soporte de tu hosting proporcionándoles el mensaje exacto que te muestra el modo depuración.

[TIP] Si no te ves capaz de hacer todo esto, no pasa nada. Muchos hostings ofrecen instalación automática de PrestaShop con un clic. Es la opción más segura para principiantes.

Esperamos que esta guía te haya sido útil. Ahora ya sabes por dónde empezar a buscar cuando las cosas se ponen cuesta arriba. ¡Mucha suerte con tu tienda online!