Fix PrestaShop Installation Failed Error (Common Causes)

¿Por qué aparece el error “PrestaShop Installation Failed”?

Si estás leyendo esto, es muy probable que hayas intentado instalar PrestaShop y te hayas encontrado con un mensaje de error frustrante. No te preocupes, es uno de los contratiempos más comunes al montar una tienda online. El error prestashop installation failed puede aparecer por muchas razones, pero la buena noticia es que la mayoría tienen una solución sencilla que puedes aplicar tú mismo, sin necesidad de ser un experto en programación.

Este mensaje genérico suele esconder problemas reales como permisos de archivos incorrectos, falta de extensiones de PHP, configuraciones del servidor o incluso problemas con la base de datos. A lo largo de esta guía, vamos a desglosar cada causa posible y te explicaré paso a paso cómo solucionarla. Al final, tendrás tu tienda funcionando.

Antes de empezar, respira hondo. Este error no significa que hayas roto nada. Es simplemente la forma que tiene el instalador de decirte que algo en su entorno no le convence. Vamos a identificar qué es y a arreglarlo juntos.

1. Requisitos previos: La lista de verificación esencial

Antes de lanzarte a modificar archivos o configuraciones, es fundamental asegurarte de que tu servidor cumple con los requisitos mínimos. Muchas veces, el error prestashop installation failed aparece simplemente porque el entorno no es compatible.

### Versión de PHP correcta

PrestaShop es exigente con la versión de PHP. Si tu servidor usa una versión demasiado antigua o demasiado nueva, el instalador fallará. Para las versiones recientes de PrestaShop (1.7 y 8.x), necesitas PHP 7.1 o superior, aunque te recomiendo usar PHP 7.4 u 8.0 para un rendimiento óptimo.

Para verificar tu versión de PHP, puedes crear un archivo llamado info.php en la raíz de tu dominio con el siguiente contenido:

<?php phpinfo(); ?>

Luego, accede a tudominio.com/info.php desde tu navegador. Verás una tabla enorme con toda la configuración. Busca la línea que dice "PHP Version". Si no cumples el requisito, tendrás que cambiarlo desde el panel de control de tu hosting.

[WARNING] Si usas Syspanel (el panel de control con puerto de acceso 2106), asegúrate de seleccionar la versión de PHP correcta en la sección de "PHP" o "Entorno de ejecución". Es un paso que se pasa por alto y causa muchos dolores de cabeza.

### Extensiones PHP necesarias

PrestaShop necesita varias extensiones de PHP para funcionar. Las más críticas son:

PDO (para conectarse a la base de datos)
MySQLi (alternativa para la base de datos)
GD Library (para procesar imágenes)
cURL (para conexiones externas)
Zip (para instalar módulos y temas)
SimpleXML y DOM (para leer archivos de configuración)

En la mayoría de los paneles de control, puedes activar estas extensiones con un simple clic. Si estás en Syspanel, ve a la sección de "PHP" y marca las casillas correspondientes. Si no las encuentras, contacta con tu proveedor de hosting.

2. Error de permisos de archivos y carpetas

Esta es, con diferencia, la causa más común del error prestashop installation failed. PrestaShop necesita escribir archivos y carpetas en tu servidor durante la instalación. Si los permisos no son los correctos, el proceso se detiene en seco.

### ¿Qué permisos necesita PrestaShop?

Los archivos deben tener permisos 644 y las carpetas 755. Sin embargo, durante la instalación, PrestaShop necesita poder escribir en ciertos directorios, por lo que temporalmente puedes necesitar permisos 777 en:

/config
/cache
/log
/img
/mails
/modules
/themes
/var
/translations
/upload
/download

### Cómo cambiar los permisos

Tienes dos formas de hacerlo: mediante el administrador de archivos de tu panel de control o mediante FTP.

Usando el Administrador de Archivos de Syspanel (puerto 2106):

Accede a tu Syspanel y navega hasta el "Administrador de archivos".
Ve a la raíz de tu instalación de PrestaShop (normalmente public_html o www).
Selecciona todas las carpetas y archivos.
Busca la opción "Cambiar permisos" o "Chmod".
Introduce 755 para carpetas y 644 para archivos. Si te da error, prueba con 777 en las carpetas mencionadas anteriormente.

Usando un cliente FTP (como FileZilla):

Conéctate a tu servidor.
Selecciona la carpeta raíz de PrestaShop.
Haz clic derecho y selecciona "Permisos de archivo".
Introduce el valor numérico y marca "Aplicar a todos los subdirectorios y archivos".

[TIP] Después de completar la instalación, es imprescindible volver a cambiar los permisos a 644 para archivos y 755 para carpetas. Dejar permisos 777 es un grave riesgo de seguridad.

3. Problemas con la base de datos

Otra causa muy frecuente del fallo de instalación está relacionada con la base de datos. El instalador no puede crear las tablas, o no puede conectarse al servidor MySQL.

### Credenciales incorrectas

Asegúrate de que el nombre de la base de datos, el usuario y la contraseña son 100% correctos. A veces, los paneles de control generan prefijos como usuario_basededatos. Si copias y pegas con un espacio extra, el error aparecerá.

### El usuario no tiene privilegios

En algunos hostings, el usuario de la base de datos no tiene todos los privilegios sobre la base de datos. Debes asegurarte de que el usuario tiene permisos de SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP.

En Syspanel, puedes gestionar esto en la sección de "Bases de datos". Edita el usuario y marca todos los privilegios.

### El prefijo de las tablas

PrestaShop te pide un prefijo para las tablas (por defecto ps_). Si estás reutilizando una base de datos que ya tenía tablas, es posible que haya un conflicto. Te recomiendo usar un prefijo único como mishop_ para evitar colisiones.

4. El archivo settings.inc.php y la carpeta /install

PrestaShop es muy estricto con la seguridad. Si el archivo de configuración ya existe, o si la carpeta /install no se puede eliminar, el instalador se negará a continuar.

### Eliminar la carpeta /install

Después de una instalación fallida o de un intento previo, PrestaShop puede bloquearse si detecta que la carpeta /install sigue presente. Debes eliminarla completamente.

[WARNING] No renombres la carpeta a install_old ni la muevas. Debes eliminarla por completo. De lo contrario, PrestaShop pensará que la instalación ya está hecha y te mostrará un error de seguridad.

### El archivo settings.inc.php

En versiones anteriores de PrestaShop, el archivo /config/settings.inc.php era el que almacenaba la configuración. Si este archivo existe, el instalador se detiene. En versiones modernas, la configuración se guarda en /app/config/parameters.php. Asegúrate de que estos archivos no existan antes de empezar.

Si ya has intentado instalar antes, borra estos archivos o la carpeta /install para empezar de cero.

5. Errores de memoria y tiempo de ejecución

A veces, el error prestashop installation failed se debe a que el servidor no tiene suficiente memoria asignada a PHP, o el tiempo máximo de ejecución es demasiado corto. La instalación de PrestaShop es un proceso pesado que puede tardar varios minutos.

### Aumentar el límite de memoria

Puedes aumentar el límite de memoria editando el archivo php.ini o mediante el panel de control. Busca la directiva memory_limit y cámbiala a 512M o incluso 1G durante la instalación.

Si no tienes acceso al php.ini, puedes crear un archivo llamado .htaccess en la raíz con la siguiente línea:

php_value memory_limit 512M

### Aumentar el tiempo de ejecución

De manera similar, busca max_execution_time y cámbialo a 300 (5 minutos) o más.

[INFO] En Syspanel, puedes configurar estos valores en la sección de "PHP" o "Configuración avanzada". Busca los campos de "Memory Limit" y "Max Execution Time".

6. Problemas con el servidor web (Apache/Nginx)

La configuración del servidor web también puede interferir. Si estás usando Apache, asegúrate de que el módulo mod_rewrite está activo. PrestaShop lo necesita para las URLs amigables, y aunque no es imprescindible para la instalación, puede causar errores extraños.

### Activar mod_rewrite

En la mayoría de los paneles, es tan simple como marcar una casilla. En Syspanel, busca "Apache" y activa mod_rewrite. Si no lo encuentras, contacta con soporte.

### El archivo .htaccess

Durante la instalación, PrestaShop genera un archivo .htaccess. Si este archivo ya existe con contenido corrupto, puede bloquear el proceso. Elimina cualquier .htaccess existente antes de comenzar la instalación.

7. Conflictos con extensiones o temas

Si estás reutilizando un servidor que ya tenía otro CMS (como WordPress) o si tienes módulos de terceros, es posible que haya conflictos. Lo mejor es instalar PrestaShop en un directorio limpio, sin otros archivos.

### Instalación en subdirectorio vs raíz

Si tu dominio principal ya tiene una web, instala PrestaShop en un subdirectorio como tudominio.com/tienda. Esto aísla cualquier conflicto potencial.

8. Solución rápida: El modo de depuración

PrestaShop tiene un modo de depuración que te muestra el error exacto en lugar del mensaje genérico. Para activarlo, tienes que editar el archivo config/defines.inc.php (en versiones 1.7) o app/config/parameters.php (en versiones 8.x).

Busca la línea que dice _PS_MODE_DEV_ y cámbiala a true:

define('_PS_MODE_DEV_', true);

Guarda el archivo y vuelve a intentar la instalación. Ahora verás un mensaje de error detallado con la línea exacta donde falla. Ese mensaje es oro puro. Puedes buscarlo en Google o copiarlo en un foro de soporte para obtener ayuda específica.

[TIP] No olvides volver a cambiar _PS_MODE_DEV_ a false cuando termines la instalación para no exponer información sensible.

9. Preguntas frecuentes (FAQ) sobre el error de instalación

### ¿Puedo instalar PrestaShop en un hosting compartido?

Sí, es posible, pero asegúrate de que tu plan cumpla con los requisitos de PHP y memoria. Muchos hostings económicos tienen restricciones que causan el error prestashop installation failed.

### ¿Qué hago si el instalador se queda en "Paso 3" o "Paso 4"?

Esto suele ser un problema de permisos en las carpetas /cache o /var. Vuelve a revisar la sección 2 de esta guía y asegúrate de que esas carpetas tienen permisos 777 durante la instalación.

### ¿Necesito crear la base de datos antes de instalar?

Sí, la mayoría de los paneles de control te permiten crear la base de datos y el usuario antes de empezar. Es recomendable hacerlo, para tener las credenciales a mano.

### ¿Cómo sé si mi servidor usa Syspanel?

Si tu proveedor de hosting te da acceso a un panel con un puerto específico (2106), es muy probable que sea Syspanel. En ese caso, para cambiar la versión de PHP o los permisos, utiliza las herramientas integradas en ese panel.

### ¿El error puede deberse a un antivirus o firewall?

En casos muy raros, sí. Algunos firewalls de servidor bloquean ciertas funciones de PHP. Desactiva temporalmente cualquier firewall de aplicación web (WAF) para probar.

10. Resumen final y checklist de solución

Para terminar, aquí tienes una lista de verificación rápida para resolver el error prestashop installation failed:

Verifica la versión de PHP (debe ser 7.4 u 8.0).
Activa todas las extensiones PHP necesarias (PDO, GD, cURL, Zip, etc.).
Cambia los permisos de las carpetas a 777 temporalmente.
Asegúrate de que la base de datos existe y que el usuario tiene todos los privilegios.
Elimina la carpeta /install y los archivos de configuración antiguos.
Aumenta la memoria y el tiempo de ejecución de PHP.
Activa mod_rewrite en Apache.
Activa el modo de depuración para ver el error exacto.
Desactiva cualquier firewall que pueda estar interfiriendo.
Prueba en un subdirectorio limpio si tienes otros CMS instalados.

Siguiendo estos pasos, en el 95% de los casos el problema se resuelve. Si aun así no funciona, no te desesperes. Copia el mensaje de error exacto del modo de depuración y busca en foros especializados. La comunidad de PrestaShop es muy activa y siempre hay alguien dispuesto a ayudar.

[INFO] Recuerda que si tu hosting usa Syspanel, el acceso se realiza a través del puerto 2106. Ahí encontrarás todas las herramientas mencionadas en esta guía: gestión de PHP, bases de datos, permisos y más.

¡Buena suerte con tu tienda online! Con paciencia y estos trucos, el error prestashop installation failed será solo un mal recuerdo.