Problemas de instalación de PrestaShop: Soluciones rápidas

Primeros pasos: identifica el tipo de error

Cuando PrestaShop no instala, lo primero es mantener la calma. La mayoría de los fallos tienen una causa común y una solución sencilla. Antes de tocar nada, te recomiendo anotar el mensaje exacto de error que aparece en pantalla. Esto es oro puro para el diagnóstico.

Los errores PrestaShop más habituales en la instalación se dividen en tres grandes grupos: errores de servidor, errores de base de datos y errores de permisos de archivos. Cada uno tiene su propio tratamiento y, en esta guía, vamos a verlos todos paso a paso.

Requisitos previos: ¿tu servidor es compatible?

Antes de buscar soluciones complejas, verifica que tu hosting cumple los requisitos mínimos. PrestaShop es una aplicación exigente y, si tu servidor se queda corto, tendrás problemas instalación desde el primer minuto.

Requisitos recomendados para PrestaShop 8.x

PHP 7.2.5 o superior (idealmente PHP 8.0 o 8.1).
MySQL 5.6 o superior, o MariaDB 10.1 o superior.
Extensión GD Library activada.
Extensión cURL activada.
Extensión OpenSSL activada.
Memoria PHP de al menos 256 MB.
Espacio en disco: mínimo 500 MB, aunque te recomiendo 1 GB o más.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso al panel de administración se realiza por el puerto 2106. Allí podrás gestionar versiones de PHP, bases de datos y permisos de archivos de forma visual y sencilla.

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

Accede a tu panel Syspanel escribiendo https://tu-dominio.com:2106 en tu navegador.
Ve a la sección "Web" o "Dominios" y busca tu dominio.
Dentro de las opciones del dominio, verás un selector de versión de PHP.
Selecciona una versión compatible (por ejemplo, PHP 8.1) y guarda los cambios.

Si tu hosting no es de Syspanel, busca en el panel de tu proveedor una opción similar llamada "Selector de PHP" o "Versión de PHP".

Error: "PrestaShop no instala" o se queda en blanco

Este es, con diferencia, el error más frustrante. La pantalla se queda en blanco o la instalación se detiene sin explicación. Las causas más comunes son las siguientes.

1. Memoria PHP insuficiente

PrestaShop necesita bastante memoria para ejecutar el instalador. Si tu límite es de 128 MB o menos, es muy probable que el proceso se interrumpa.

Solución:

Accede a tu panel de hosting (Syspanel u otro).
Busca la opción "Editar archivo php.ini" o "Configuración de PHP".
Cambia el valor de memory_limit a 256M o 512M.
Guarda los cambios y reinicia PHP si es necesario.

Si no tienes acceso a php.ini, puedes crear un archivo llamado php.ini en la raíz de tu dominio con el siguiente contenido:

memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

2. Error de conexión a la base de datos

Otro clásico. PrestaShop no puede conectar con MySQL o MariaDB. Esto suele deberse a datos incorrectos o a que la base de datos no existe.

Solución paso a paso:

Ve a tu panel de hosting y abre la sección de bases de datos MySQL.
Crea una nueva base de datos con un nombre sencillo, por ejemplo prestashop_db.
Crea un usuario para esa base de datos y asígnale todos los privilegios.
Anota el nombre de la base de datos, el usuario y la contraseña.
Durante la instalación de PrestaShop, introduce estos datos exactamente como los has creado.
El servidor de base de datos suele ser localhost, pero en algunos hostings puede ser una dirección IP o un nombre como mysql.tudominio.com.

[WARNING] No uses caracteres especiales en el nombre de la base de datos. Solo letras, números y guiones bajos. Los símbolos como - o @ pueden generar errores de conexión.

3. Permisos de archivos incorrectos

PrestaShop necesita escribir en ciertos archivos y carpetas durante la instalación. Si los permisos son demasiado restrictivos, el instalador fallará.

Solución:

Conéctate a tu servidor por FTP o desde el administrador de archivos de Syspanel.
Ve a la carpeta donde has subido PrestaShop.
Los archivos deben tener permiso 644 y las carpetas 755.
Durante la instalación, la carpeta config, cache, log y img deben tener permisos 777 temporalmente.

Comandos para terminal (si tienes acceso SSH):

find /ruta/a/prestashop -type f -exec chmod 644 {} \;
find /ruta/a/prestashop -type d -exec chmod 755 {} \;
chmod -R 777 config cache log img

[TIP] Después de completar la instalación, vuelve a poner los permisos a 644 y 755. Dejar carpetas en 777 es un riesgo de seguridad.

Error: "No se puede crear el archivo settings.inc.php"

Este es un error muy concreto y tiene una solución muy clara. Durante la instalación, PrestaShop intenta crear el archivo de configuración settings.inc.php en la carpeta config. Si no tiene permisos de escritura, el proceso se detiene.

Solución:

Accede a la carpeta config de tu instalación de PrestaShop.
Busca el archivo settings.inc.php (puede que ya exista pero esté vacío).
Cambia los permisos de ese archivo a 777.
También cambia los permisos de la carpeta config a 777.
Vuelve a intentar la instalación.

Si el archivo no existe, créalo manualmente con permisos 777 y déjalo vacío. PrestaShop lo llenará con los datos de configuración durante la instalación.

Error: "La extensión GD no está habilitada"

PrestaShop usa la librería GD para procesar imágenes. Si no está activada, la instalación fallará o la tienda funcionará mal.

Solución:

En Syspanel, ve a la configuración de PHP de tu dominio.
Busca la lista de extensiones y activa gd, curl, openssl, mbstring y pdo_mysql.
Guarda los cambios y verifica que aparecen como activas.

Si usas otro panel, busca "Extensiones PHP" o "Módulos PHP" y activa las mismas.

Error: "El archivo de instalación no es válido" o "Archivo corrupto"

A veces, el archivo ZIP que descargaste de PrestaShop viene dañado o incompleto. Esto es más común de lo que parece, especialmente si la descarga se interrumpió.

Solución:

Descarga de nuevo el paquete de instalación desde la web oficial de PrestaShop.
Verifica el checksum del archivo si es posible.
Descomprime el ZIP en tu ordenador con un programa como 7-Zip o WinRAR.
Sube los archivos descomprimidos por FTP, no el ZIP directamente.
Asegúrate de que la subida se complete al 100%. Los clientes FTP suelen mostrar una barra de progreso.

[INFO] Si usas Syspanel, puedes subir el ZIP directamente al administrador de archivos y descomprimirlo ahí. Es más rápido y evita errores de transferencia.

Error: "No se puede conectar con la base de datos" (revisión avanzada)

Si ya has verificado los datos y sigue fallando, el problema puede estar en el servidor de base de datos. Algunos hostings usan un puerto diferente o un socket UNIX.

Solución:

Prueba con 127.0.0.1 en lugar de localhost.
Si tu hosting usa MariaDB, el servidor suele ser el mismo, pero a veces cambia el puerto.
Contacta con tu proveedor de hosting para confirmar el host, puerto y tipo de conexión.
Si tienes acceso SSH, prueba a conectarte manualmente con el cliente MySQL:

mysql -u tu_usuario -p -h localhost

Si la conexión funciona por terminal, el problema está en los datos que introduces en el instalador.

Error: "El directorio no es escribible"

PrestaShop necesita escribir en varias carpetas durante y después de la instalación. Si alguna no tiene permisos, el instalador te lo indicará.

Solución:

Revisa las carpetas que marca el instalador como problemáticas.
Cambia sus permisos a 755 o 777 según indique.
Las carpetas más comunes son: cache, log, img, config, translations, var.
En Syspanel, puedes cambiar permisos desde el administrador de archivos con clic derecho > "Permisos".

Error: "La versión de PHP no es compatible"

PrestaShop 8 requiere PHP 7.2.5 como mínimo. Si tu servidor tiene una versión anterior, la instalación no continuará.

Solución:

Actualiza la versión de PHP desde tu panel de hosting.
En Syspanel, ve a la configuración del dominio y selecciona PHP 8.1 o 8.2.
Si tu proveedor no permite cambiar la versión, considera migrar a un hosting más moderno.

[WARNING] No uses PHP 8.2 si tu versión de PrestaShop es antigua (1.6 o 1.7). Consulta la tabla de compatibilidad oficial antes de actualizar.

Error: "El archivo .htaccess no se puede crear"

Este error es típico en servidores Apache o LiteSpeed. El archivo .htaccess es esencial para las URLs amigables y el correcto funcionamiento de la tienda.

Solución:

Verifica que el módulo mod_rewrite esté activado en Apache.
Si el instalador no puede crear el archivo, créalo tú manualmente.
Copia el contenido de ejemplo que viene en el paquete de PrestaShop (archivo htaccess.sample).
Renómbralo a .htaccess y súbelo a la raíz.
Dale permisos 644.

Si no encuentras el archivo de muestra, puedes crear uno vacío y PrestaShop lo completará durante la instalación.

Error: "Tiempo de ejecución excedido"

Si la instalación se detiene con un error de tiempo límite, es porque PHP tiene un límite de ejecución demasiado bajo.

Solución:

Aumenta max_execution_time en php.ini a 300 o 600.
Si no tienes acceso a php.ini, crea un archivo .htaccess en la raíz con:

php_value max_execution_time 600

También puedes añadir al inicio del archivo config/settings.inc.php (si existe) la línea:

ini_set('max_execution_time', 600);

Error: "No se puede crear la tabla de la base de datos"

Este error suele indicar que el usuario de la base de datos no tiene privilegios suficientes o que la base de datos ya contiene tablas con el mismo nombre.

Solución:

Asegúrate de que el usuario tenga todos los privilegios: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP.
Si la base de datos no está vacía, vacíala o crea una nueva.
Prueba con un prefijo de tabla diferente durante la instalación, por ejemplo ps_.

Después de la instalación: consejos finales

Una vez superados los errores PrestaShop y completada la instalación, te recomiendo hacer lo siguiente:

Elimina la carpeta install del servidor. Es una puerta de entrada para ataques.
Cambia los permisos de config y cache de 777 a 755.
Activa el modo mantenimiento mientras personalizas tu tienda.
Configura la tienda en modo producción desde el panel de administración.
Haz una copia de seguridad de la base de datos y los archivos.

[TIP] Guarda el archivo settings.inc.php en un lugar seguro. Contiene las claves de acceso a tu base de datos y es fundamental para restaurar tu tienda si algo falla.

Preguntas frecuentes (FAQ) sobre problemas de instalación

¿Por qué PrestaShop no instala en mi hosting gratuito?

Los hostings gratuitos suelen tener limitaciones de memoria, PHP desactualizado o falta de extensiones. Te recomiendo usar un hosting de pago con soporte técnico que garantice compatibilidad con PrestaShop.

¿Puedo instalar PrestaShop en Syspanel?

Sí, Syspanel (acceso por el puerto 2106) es totalmente compatible con PrestaShop. Solo asegúrate de configurar correctamente la versión de PHP y los permisos de archivos.

¿Qué hago si el instalador se queda en el 50%?

Normalmente es un problema de memoria o de tiempo de ejecución. Aumenta memory_limit y max_execution_time como hemos explicado. Si persiste, revisa los logs de error de PHP en la carpeta var/logs.

¿Cómo restauro una instalación fallida?

Elimina todos los archivos de PrestaShop del servidor, vacía la base de datos y vuelve a empezar desde cero. Asegúrate de que las carpetas tengan los permisos correctos antes de ejecutar el instalador.

¿Los errores de instalación pueden deberse al navegador?

En raras ocasiones, el navegador puede cachear páginas antiguas o bloquear cookies. Prueba en modo incógnito o con otro navegador. También puedes limpiar la caché del navegador antes de reintentar.

Resumen rápido de solución de errores

Problema	Solución rápida
Pantalla en blanco	Aumentar memoria PHP
No conecta a BD	Verificar datos y crear BD nueva
Permisos denegados	Cambiar a 777 durante instalación
PHP incompatible	Actualizar a PHP 8.1
Extensión GD falta	Activar en panel de hosting
Tiempo excedido	Subir `max_execution_time`
Archivo corrupto	Redescargar y subir por FTP

Con esta guía, el troubleshooting de tu instalación de PrestaShop debería ser mucho más llevadero. Recuerda que la paciencia es clave y que, en la mayoría de los casos, los problemas se resuelven con un ajuste de configuración o un cambio de permisos. Si todo lo demás falla, no dudes en contactar con el soporte de tu hosting: ellos conocen su infraestructura y podrán ayudarte a identificar el problema exacto.