Errores comunes de instalación de PrestaShop en cPanel y cómo solucionarlos

Instalar PrestaShop puede parecer una tarea titánica si no estás familiarizado con el entorno de alojamiento. Pero no te preocupes, estás en el lugar correcto. Como técnico de soporte, he visto cientos de casos de errores PrestaShop cPanel, y la buena noticia es que la gran mayoría tienen soluciones sencillas que puedes aplicar tú mismo en pocos minutos.

En esta guía extensa y práctica, vamos a desglosar los problemas instalación PrestaShop más comunes, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Olvídate del estrés y vamos a por ello. Al final, tendrás tu tienda online funcionando a la perfección.

Antes de Empezar: Requisitos Mínimos y Preparación

Muchos problemas instalación PrestaShop no son errores en sí, sino consecuencias de no cumplir los requisitos del sistema. Es como intentar meter un camión en un garaje para un coche pequeño: no va a caber. Antes de tocar nada, verifica que tu plan de hosting en cPanel cumple con lo siguiente:

Versión de PHP: PrestaShop 8.x requiere PHP 7.2.5 o superior, pero te recomiendo encarecidamente usar PHP 8.0 o 8.1 para un rendimiento óptimo.
Memoria Límite (memory_limit): Debe ser al menos 256 MB. Con 128 MB vas justo y dará errores extraños.
Extensiones PHP: Necesitas tener activadas extensiones como curl, gd, intl, mbstring, openssl, pdo_mysql, zip y fileinfo. La mayoría están activadas por defecto, pero a veces no.

Cómo Verificar los Requisitos en cPanel

Si no sabes cómo comprobar esto, sigue estos pasos:

Accede a tu cPanel (normalmente en tudominio.com/cPanel).
Busca la sección "Software" o "Múltiples versiones de PHP" (el nombre cambia según el proveedor).
Haz clic en "Administrar" o en el icono de la versión de PHP actual.
Se abrirá una ventana con la versión de PHP y una lista de extensiones. Asegúrate de que las mencionadas arriba tengan una marca de verificación.

[WARNING] Si cambias la versión de PHP, hazlo con cuidado. Si tu web actual usa una versión antigua, podrías romperla. Este cambio solo afecta al dominio que selecciones.

Error 1: "El archivo de configuración no es escribible" o Permisos Incorrectos

Este es, sin duda, el rey de los errores PrestaShop cPanel. Aparece al inicio de la instalación y suele ser un problema de permisos de archivos. En cPanel, los archivos deben tener permisos 644 y las carpetas 755. Si por error están en 777 o en 444, la instalación fallará.

Solución Paso a Paso para los Permisos

Ve a tu Administrador de Archivos en cPanel (dentro de la sección "Archivos").
Navega hasta la carpeta donde has subido PrestaShop (normalmente public_html).
Selecciona todos los archivos y carpetas (puedes usar Ctrl+A o el botón "Seleccionar todo").
Haz clic en "Permisos" en la barra superior.
En la ventana emergente, escribe 755 en el campo de permisos numéricos y asegúrate de que la casilla de "Cambiar recursivamente" esté marcada.
Haz clic en "Cambiar permisos".

Repite el proceso, pero esta vez solo para los archivos (no carpetas). Selecciónalos todos y pon permisos 644.

[TIP] Si tu proveedor usa "Syspanel" (antes conocido como HestiaCP), el acceso a los permisos es similar, pero el puerto de acceso al panel es el 2106. La lógica es la misma: archivos 644 y carpetas 755.

Error 2: "Error de conexión a la base de datos" o "No se puede conectar a MySQL"

Otro clásico. PrestaShop necesita una base de datos para guardar toda la información. Este error significa que los datos que has introducido (nombre de la BD, usuario o contraseña) son incorrectos, o que la base de datos no existe.

Solución: Crear y Configurar la Base de Datos Correctamente

En cPanel, busca la sección "Bases de datos" y haz clic en "Bases de datos MySQL".
Crea una nueva base de datos. Ponle un nombre que recuerdes, por ejemplo, presta_bd.
Ahora, en la misma página, crea un usuario de base de datos. Por ejemplo, presta_user y una contraseña fuerte (guárdala, la necesitarás).
Desplázate hacia abajo hasta la sección "Añadir usuario a la base de datos".
Selecciona tu usuario y tu base de datos, y haz clic en "Añadir".
En la siguiente pantalla, marca TODOS LOS PRIVILEGIOS y haz clic en "Realizar cambios".

Ahora, cuando el instalador de PrestaShop te pida los datos, usa exactamente el nombre de la base de datos y el usuario que has creado, incluyendo el prefijo que cPanel añade (por ejemplo, usuario_presta_bd y usuario_presta_user).

[INFO] El prefijo de cPanel es tu nombre de usuario de hosting, y es obligatorio incluirlo en el nombre de la BD y del usuario. A veces se nos olvida y por eso falla la conexión.

Error 3: La Página se Queda en Blanco o Aparece un Error 500

Un error 500 o una página en blanco es frustrante porque no te dice nada. Las causas suelen ser: falta de memoria PHP, un archivo .htaccess corrupto o una incompatibilidad de versiones.

Solución para el Error 500

Aumenta la memoria PHP: Crea un archivo llamado php.ini en la raíz de tu PrestaShop (donde está index.php). Dentro, escribe: memory_limit = 512M. Si no puedes crearlo, usa el "Editor de archivos" de cPanel.
Revisa el .htaccess: Si tienes un archivo .htaccess existente, renómbralo a .htaccess.bak temporalmente. A veces la instalación lo crea mal. Si la web carga, el problema era ese. Luego puedes generar uno nuevo desde el backoffice de PrestaShop (Parámetros avanzados > Rendimiento > Generar .htaccess).
Comprueba el error real: Ve a "Métricas de errores" en cPanel (sección "Métricas"). Te dirá la línea exacta del error. A menudo es un problema con la extensión intl que no está activada.

[WARNING] No dejes el .htaccess renombrado para siempre. Si lo haces, las URLs amigables de PrestaShop dejarán de funcionar.

Error 4: "El archivo settings.inc.php no existe o no es legible"

Este es un error PrestaShop cPanel muy típico en versiones antiguas (1.6 y 1.7). El archivo settings.inc.php guarda la configuración de la conexión a la base de datos. Si no se puede leer, PrestaShop no puede arrancar.

Solución Rápida

Ve a la carpeta config dentro de tu instalación de PrestaShop.
Busca el archivo settings.inc.php.
Asegúrate de que existe. Si no existe, es que la instalación no se completó. Deberás volver a ejecutar el instalador (borra todo y sube los archivos de nuevo).
Si existe, comprueba sus permisos. Deben ser 444 (solo lectura) o 644. Si está en 777, cámbialo a 444.

[TIP] Si después de cambiar los permisos sigue fallando, el archivo podría estar vacío. Ábrelo con el editor de cPanel y verifica que contiene las constantes _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ con los valores correctos.

Error 5: Problemas con la Subida de Archivos (Tiempo de Espera o Archivos Incompletos)

Si estás subiendo PrestaShop a través del Administrador de Archivos de cPanel, es muy común que la subida falle si el archivo ZIP es grande (más de 50 MB). Esto causa problemas instalación PrestaShop porque faltan archivos y nadie sabe por qué.

Solución: Subir y Descomprimir en el Servidor

Sube el ZIP a public_html usando el Administrador de Archivos.
Una vez subido, haz clic derecho sobre el archivo ZIP y selecciona "Extraer".
cPanel lo descomprimirá directamente en el servidor, evitando los límites de tiempo de tu conexión.
Después de extraer, mueve todos los archivos de la carpeta que se creó (por ejemplo, prestashop/) a public_html directamente.

[WARNING] Si tu conexión a internet es lenta, este proceso puede tardar. No cierres la pestaña del navegador hasta que veas el mensaje de "Archivo extraído correctamente".

Error 6: "La URL no es válida" o Problemas con el Dominio

A veces, al instalar, PrestaShop te dice que la tienda está en una URL incorrecta, o te redirige a localhost o a una IP. Esto suele pasar si has movido la web de un servidor local a cPanel.

Solución: Forzar la URL Correcta

Accede a tu cPanel y busca "Base de datos MySQL".
Abre phpMyAdmin (icono al lado del nombre de tu BD).
Selecciona tu base de datos en el panel izquierdo.
Haz clic en la tabla ps_shop_url (o prestashop_shop_url).
Haz clic en "Editar" (el lápiz) en la fila existente.
Cambia el campo domain a tu dominio (ej. midominio.com) y el campo physical_uri a / (si está en la raíz).
Guarda los cambios.

Después de esto, limpia la caché de tu navegador y vuelve a intentarlo.

Error 7: El Instalador se Detiene en el Paso 3 o 4 (Problemas de PHP)

Los pasos finales de la instalación son los más pesados para el servidor. Si se detiene sin razón, es porque el tiempo de ejecución de PHP es demasiado bajo o la memoria es insuficiente.

Solución: Ajustar el Tiempo de Ejecución

Crea un archivo .htaccess en la raíz de tu PrestaShop (si no existe).
Añade estas líneas al final:

<IfModule mod_php7.c>
php_value max_execution_time 600
php_value max_input_time 600
php_value memory_limit 512M
</IfModule>

Guarda el archivo e intenta la instalación de nuevo.

[INFO] Si tu hosting usa PHP como módulo de Apache (lo más común), estas directivas funcionarán. Si usas PHP-FPM, deberías usar un .user.ini en su lugar, pero las líneas serían las mismas sin las etiquetas <IfModule>.

Error 8: El Icono de Carga Infinita o "Ajax" que No Funciona

Este es un error PrestaShop cPanel más moderno. La instalación avanza, pero las animaciones de carga se quedan congeladas. Esto es un problema de JavaScript o de la extensión curl.

Solución para el Error de Ajax

Verifica curl: Ve a "Seleccionar versión de PHP" y asegúrate de que curl tiene una marca de verificación. Sin esta extensión, las peticiones internas de PrestaShop fallan.
Limpia la caché del navegador: A veces el navegador guarda una versión antigua del JavaScript. Prueba en modo incógnito.
Desactiva el firewall temporalmente: Si tu hosting tiene un firewall de aplicaciones (mod_security), podría estar bloqueando las peticiones AJAX. Pide a tu soporte que lo desactiven para tu dominio temporalmente.

Error 9: "No se puede escribir en la carpeta /cache" o /log

PrestaShop necesita escribir en varias carpetas para funcionar (cache, log, upload, etc.). Si estas carpetas no tienen permisos de escritura, la instalación fallará o la tienda funcionará a medias.

Solución: Permisos de Escritura Específicos

A diferencia del Error 1, aquí sí necesitamos permisos más permisivos en carpetas concretas. No en todo, solo en las que te indique el instalador.

En el Administrador de Archivos, navega a la carpeta de PrestaShop.
Busca las carpetas: cache, log, img, upload, download, translations, config y themes.
Haz clic derecho sobre cada una (una a una) y selecciona "Permisos".
Pon 755 o 775 (si 755 no funciona, prueba 775).
Marca la casilla "Cambiar recursivamente" para que se aplique a todos los archivos dentro de esa carpeta.

[WARNING] No pongas 777 en todo el directorio. Es un riesgo de seguridad grave. Solo usa 775 si es estrictamente necesario y luego vuelve a 755.

Error 10: Problemas con la Zona Horaria o Fecha

Este error es menos común pero aparece. PrestaShop te dice que la fecha es inválida o que no puede configurar la zona horaria.

Solución Rápida

En tu cPanel, busca la sección "Zona horaria" (a veces está dentro de "Preferencias" o "Configuración del servidor").
Selecciona la zona horaria de tu país (ej. Europe/Madrid).
Guarda los cambios e intenta la instalación de nuevo.

Preguntas Frecuentes (FAQ) sobre Errores PrestaShop cPanel

Para terminar, respondo a las dudas que más me llegan al soporte.

¿Por qué siempre me da error al conectar con la base de datos si estoy seguro de que la contraseña es correcta?

El problema suele ser el prefijo. En cPanel, el nombre real de la base de datos es usuario_nombrebd. Si solo pones nombrebd, nunca conectará. Revisa que en el instalador pones el nombre completo tal y como aparece en cPanel.

¿Puedo instalar PrestaShop en un subdominio? ¿Cambia algo?

Sí, puedes. Solo asegúrate de subir los archivos a la carpeta del subdominio (ej. public_html/tienda). El error más común aquí es que la gente los sube a public_html y luego no entiende por qué el subdominio no funciona.

He movido mi web desde un servidor local (XAMPP) a cPanel y no funciona. ¿Qué hago?

Este es un problema instalación PrestaShop muy específico. Deberás editar el archivo config/settings.inc.php manualmente y cambiar las constantes de la base de datos, o usar la herramienta de "Parámetros avanzados > Base de datos" en el backoffice (si es que puedes acceder). Si no puedes acceder, repara el settings.inc.php como explicamos en el Error 4.

¿Qué hago si después de todo sigue sin funcionar?

Te recomiendo borrar todos los archivos y la base de datos, y empezar de cero. A veces, un archivo corrupto durante la subida es la causa de todo. Sube de nuevo el ZIP y extrae en el servidor. Esto soluciona el 90% de los casos que me llegan.

¿Es mejor usar el instalador de PrestaShop de mi hosting (Softaculous) que la instalación manual?

Si tu hosting tiene Softaculous, úsalo. Es mucho más fácil y evita el