Errores comunes al instalar PrestaShop y cómo solucionarlos

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque has intentado instalar PrestaShop y te has topado con algún error. No te preocupes, es más común de lo que crees y, con esta guía, vas a solucionar los errores instalación PrestaShop más habituales paso a paso. Vamos a convertir ese momento de frustración en una instalación exitosa.

1. El temido "Error 500" o pantalla en blanco durante la instalación

Este es, sin duda, uno de los errores instalación PrestaShop más frecuentes. Ves la pantalla de bienvenida, haces clic en "Siguiente" y, de repente, todo se queda en blanco o aparece un feo Error 500. La causa suele ser un límite de memoria de PHP insuficiente o una configuración incorrecta del servidor.

Solución paso a paso

Aumenta el límite de memoria PHP. PrestaShop necesita al menos 256 MB de memoria para funcionar correctamente durante la instalación. Debes modificar el archivo php.ini de tu servidor. Si usas Syspanel (accede por el puerto 2106), puedes hacerlo desde el panel de administración de archivos o pidiendo a tu hosting que lo ajuste. Busca estas líneas y cámbialas:
- memory_limit = 256M
- max_execution_time = 120 (aumenta el tiempo de ejecución)
- upload_max_filesize = 64M
- post_max_size = 64M
Verifica los requisitos del servidor. PrestaShop no se instalará si tu servidor no cumple con los requisitos mínimos. Asegúrate de tener:
- PHP 7.1 o superior (recomendado PHP 7.4 o 8.0).
- MySQL 5.6 o superior (o MariaDB 10.1+).
- Extensiones PHP activadas: gd, curl, json, mbstring, openssl, pdo_mysql, zip, fileinfo, intl.
Revisa los logs del servidor. Si el error persiste, busca el archivo de registro de errores de PHP o del servidor web (Apache/Nginx). Normalmente se encuentra en /var/log/ o en la raíz de tu hosting. El mensaje de error te dará la pista exacta.

[WARNING] Si tu servidor usa Syspanel, recuerda que el acceso es por el puerto 2106. Una vez dentro, busca la sección "Configuración de PHP" o "PHP Settings" para modificar estos valores de forma gráfica.

2. "PrestaShop no instala" por problemas con la base de datos

Otro clásico. Llegas al paso de configuración de la base de datos y te sale un mensaje como "No se puede conectar a la base de datos" o "Error al crear las tablas". Esto es muy común si los datos de acceso no son correctos o si el usuario de la base de datos no tiene permisos suficientes.

Solución paso a paso

Crea la base de datos correctamente. No intentes que PrestaShop la cree sola. Hazlo manualmente desde el panel de control de tu hosting (phpMyAdmin o Syspanel). Anota el nombre exacto de la base de datos, el usuario y la contraseña.
Verifica los permisos del usuario. El usuario de la base de datos debe tener todos los privilegios sobre esa base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). En Syspanel (puerto 2106), al crear el usuario, asegúrate de marcar la casilla "Todos los privilegios" o "Grant all privileges".
Comprueba el prefijo de las tablas. A veces, si ya has intentado instalar PrestaShop antes, quedan tablas antiguas. Cambia el prefijo en el instalador (por ejemplo, de ps_ a ps2_) para evitar conflictos.
Revisa el servidor de base de datos. El campo "Servidor de base de datos" suele ser localhost. Si tu hosting usa un servidor externo, te lo habrán proporcionado. Nunca lo cambies a menos que estés seguro.

[TIP] Si estás en un hosting compartido y usas Syspanel, el nombre de la base de datos suele tener un prefijo con tu nombre de usuario (ejemplo: usuario_mitienda). Asegúrate de escribirlo exactamente igual, con mayúsculas y minúsculas.

3. El instalador se queda colgado en "Instalando módulos" o "Creando tablas"

Este es otro de esos errores instalación PrestaShop que desesperan. La barra de progreso avanza hasta un punto y se para. Esto suele deberse a un tiempo de ejecución de PHP demasiado bajo o a que el servidor no puede escribir en los archivos temporales.

Solución paso a paso

Aumenta el max_execution_time. Como mencionamos antes, en el archivo php.ini o desde Syspanel (puerto 2106), cambia el valor a 300 o incluso 600 (5-10 minutos). Esto le da tiempo a PrestaShop para completar todas las tareas.
Verifica los permisos de carpetas. PrestaShop necesita escribir en varias carpetas. Si los permisos son incorrectos, la instalación se detendrá. Las carpetas críticas son:
- /config/
- /cache/
- /log/
- /img/
- /mails/
- /modules/
- /themes/
- /translations/
- /upload/
- /download/
Estos directorios deben tener permisos 755 para carpetas y 644 para archivos. En Syspanel, puedes usar el administrador de archivos para cambiar permisos haciendo clic derecho sobre la carpeta.
Desactiva temporalmente el firewall o el mod_security. Algunos servidores tienen reglas de seguridad que bloquean ciertas operaciones de PrestaShop durante la instalación. Contacta con tu soporte técnico y pídeles que lo desactiven momentáneamente.

[INFO] Si usas Syspanel, puedes acceder a la configuración de PHP desde el panel principal. Busca la sección "Avanzado" o "PHP Settings". Allí podrás modificar el max_execution_time sin necesidad de editar archivos manualmente.

4. Error "La extensión cURL no está habilitada"

Este es un error muy directo. El instalador te dice que falta una extensión de PHP. PrestaShop usa cURL para comunicarse con servicios externos (como la tienda de módulos o actualizaciones). Sin ella, PrestaShop no instala.

Solución paso a paso

Activa la extensión cURL desde el panel de control. En Syspanel (puerto 2106), busca una sección llamada "PHP Extensions" o "Extensiones PHP". Localiza curl y actívala.
Si no tienes acceso, pide ayuda a tu hosting. En muchos hosting compartidos, las extensiones se activan desde el panel o contactando al soporte.
Verifica en un archivo PHP. Crea un archivo llamado info.php en la raíz de tu web con el contenido <?php phpinfo(); ?>. Accede a él desde el navegador (ejemplo: tudominio.com/info.php) y busca la sección curl. Si no aparece, no está activada. Borra este archivo después de usarlo por seguridad.

[WARNING] No olvides eliminar el archivo info.php una vez que hayas verificado. Dejarlo accesible es un grave riesgo de seguridad.

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

Si tu servidor tiene una versión de PHP muy antigua (5.6 o inferior) o demasiado moderna (8.1 o superior), PrestaShop puede negarse a instalarse. Cada versión de PrestaShop tiene requisitos específicos.

Solución paso a paso

Cambia la versión de PHP. Desde Syspanel (puerto 2106), puedes seleccionar la versión de PHP que quieres usar para tu dominio. Busca la opción "PHP Version" o "Selector de PHP". Elige una versión compatible con tu PrestaShop (por ejemplo, PHP 7.4 para PrestaShop 1.7.8).
Descarga la versión correcta de PrestaShop. Si tu servidor solo ofrece PHP 8.0, asegúrate de descargar una versión de PrestaShop que sea compatible (PrestaShop 8.x funciona bien con PHP 8.0 y 8.1).
Consulta la documentación oficial. Antes de instalar, revisa los requisitos del sistema de la versión de PrestaShop que has descargado. No asumas que cualquier versión funcionará.

[TIP] Si tienes dudas sobre qué versión de PHP usar, elige PHP 7.4. Es la más estable y compatible con la mayoría de las versiones de PrestaShop.

6. El instalador no muestra la pantalla de bienvenida (archivos corruptos)

Has subido todos los archivos, pero al ir a tudominio.com solo ves un directorio vacío o un error de "No se encuentra el archivo". Esto suele significar que la descarga de PrestaShop se corrompió o que no subiste los archivos a la carpeta correcta.

Solución paso a paso

Descarga PrestaShop de nuevo. Ve a la página oficial de PrestaShop y descarga el archivo ZIP. Asegúrate de que la descarga se complete sin errores.
Sube los archivos a la raíz de tu dominio. Si quieres que la tienda esté en tudominio.com, los archivos deben estar en la carpeta public_html o www (dependiendo de tu hosting). Si usas Syspanel (puerto 2106), usa el administrador de archivos para subir el ZIP y luego extraerlo directamente allí.
Comprueba el archivo index.php. Debe existir en la raíz. Si no está, vuelve a subir todo.
Verifica que el dominio apunte al servidor correcto. A veces, el problema no es de PrestaShop, sino de DNS. Espera unas horas si acabas de cambiar la configuración.

[INFO] Si después de subir los archivos ves un mensaje de "Index of /", significa que no hay un archivo index.php en la raíz. Revisa que hayas extraído correctamente el contenido del ZIP.

Preguntas Frecuentes (FAQ)

P: ¿Por qué después de solucionar un error, el instalador vuelve al principio?
R: PrestaShop guarda el progreso en cookies. Borra las cookies de tu navegador o abre una ventana de incógnito para empezar de nuevo.

P: ¿Puedo instalar PrestaShop en un servidor local (XAMPP, WAMP)?
R: Sí, pero es solo para pruebas. Para producción, necesitas un hosting real. Los errores suelen ser los mismos, solo cambia la forma de acceder a la configuración.

P: ¿Qué hago si el error persiste después de todo?
R: Revisa los logs del servidor. Busca en la carpeta /log/ de PrestaShop o en los logs de Apache (accede por Syspanel o pide ayuda a tu proveedor de hosting). El mensaje exacto es la clave.

P: ¿Es necesario tener conocimientos de programación para solucionar estos errores?
R: No. Con seguir los pasos de esta guía, la mayoría de los usuarios resuelven los problemas. Si algo es muy técnico, siempre puedes contactar con el soporte de tu hosting.

P: ¿Syspanel es obligatorio?
R: No, es solo el panel de control que usamos de ejemplo. Si tu hosting usa cPanel, Plesk o cualquier otro, los pasos son similares, solo cambia la interfaz.

Conclusión

Los errores instalación PrestaShop son frustrantes, pero casi siempre tienen una solución sencilla. Recuerda: verifica los requisitos del servidor, ajusta los límites de PHP, asegúrate de que la base de datos esté bien configurada y comprueba los permisos de las carpetas. Con esta guía, ya tienes las herramientas para solucionar problemas PrestaShop como un experto.

Si después de todo esto, PrestaShop no instala, no dudes en contactar con tu proveedor de hosting. A veces, la configuración del servidor necesita un ajuste que solo ellos pueden hacer. ¡Mucha suerte con tu tienda online!