Problemas instalación PrestaShop en cPanel: Soluciones y FAQ

¡Hola! Soy tu asistente técnico y hoy vamos a resolver juntos los problemas más habituales al instalar PrestaShop en cPanel. Si estás intentando montar tu tienda online y te encuentras con pantallazos en blanco, errores de base de datos o simplemente no sabes por dónde empezar, has llegado al lugar indicado. Vamos paso a paso, con un lenguaje claro y muchos consejos útiles.

Requisitos previos: ¿Qué necesitas antes de instalar PrestaShop en cPanel?

Antes de lanzarnos a la instalación, es fundamental que tu servidor cumpla con los requisitos mínimos. Si tu hosting no es compatible, te encontrarás con errores desde el primer momento.

Requisitos técnicos básicos

PHP 7.4 o superior (PrestaShop 1.7 y 8.x requieren al menos PHP 7.4; PHP 8.0 o 8.1 es lo ideal).
MySQL 5.6+ o MariaDB 10.1+.
Memoria PHP (memory_limit): Al menos 128 MB, recomendado 256 MB o más.
Extensiones PHP activas: curl, gd, json, mbstring, openssl, pdo_mysql, zip, xml, bcmath, intl, fileinfo.
cPanel con acceso a:
- File Manager (o FTP).
- phpMyAdmin (para bases de datos).
- MySQL Databases (para crear usuarios y bases de datos).
- Softaculous o instalador automático (opcional, pero facilita la vida).

[WARNING] Si tu hosting usa PHP 5.6 o inferior, PrestaShop no funcionará. Debes contactar con tu proveedor para actualizar PHP desde cPanel (sección “Select PHP Version”).

Paso 1: Preparar el entorno en cPanel

Vamos a crear el espacio donde vivirá tu tienda. Lo haremos manualmente para que entiendas cada parte, aunque después puedas usar un instalador automático.

Crear una base de datos y un usuario

Entra a cPanel y busca la sección “MySQL Databases”.
En “Create New Database”, escribe un nombre (ej. mitienda_presta) y haz clic en “Create Database”.
Baja a “Add New User” y crea un usuario (ej. usuario_presta) con una contraseña segura. Guárdala en un bloc de notas.
En “Add User to Database”, selecciona el usuario y la base de datos que acabas de crear. Marca “ALL PRIVILEGES” y haz clic en “Add”.

[TIP] Anota en un archivo de texto: Nombre de la base de datos, usuario y contraseña. Los necesitarás durante la instalación de PrestaShop.

Subir los archivos de PrestaShop a tu dominio

Descarga la última versión de PrestaShop desde prestashop.com (archivo .zip).
En cPanel, abre “File Manager” y navega hasta la carpeta public_html (o la carpeta raíz de tu dominio, como public_html/mitienda si quieres una subcarpeta).
Haz clic en “Upload” y selecciona el archivo .zip de PrestaShop.
Una vez subido, selecciona el archivo y haz clic en “Extract”. Se descomprimirá en una carpeta con el mismo nombre (ej. prestashop-1.7.8.10).
Si quieres que la tienda esté en la raíz (ej. tudominio.com), mueve todo el contenido de esa carpeta a public_html (arrastra y suelta). Si prefieres una subcarpeta (ej. tudominio.com/tienda), renombra la carpeta a tienda.

[INFO] Si usas Softaculous (instalador automático en cPanel), puedes saltarte este paso. Busca “PrestaShop” en la sección “Softaculous Apps Installer”, pero asegúrate de tener PHP 7.4+ activado.

Paso 2: Ejecutar la instalación web de PrestaShop

Ahora viene la parte divertida. Abre tu navegador y escribe la URL de tu dominio (o subcarpeta). Por ejemplo:

Si lo pusiste en la raíz: https://tudominio.com
Si lo pusiste en subcarpeta: https://tudominio.com/tienda

Deberías ver el asistente de instalación de PrestaShop. Si ves un error, no te preocupes, lo solucionaremos más abajo.

Pantallazos comunes durante la instalación

Página en blanco: Generalmente por falta de memoria PHP o extensión desactivada.
Error de conexión a la base de datos: Datos incorrectos o privilegios insuficientes.
Advertencias de requisitos: Te dirá qué extensiones PHP faltan.

Sigue los pasos del asistente:

Idioma: Selecciona español.
Licencia: Acepta los términos.
Compatibilidad del sistema: El asistente verificará los requisitos. Si todo está verde, sigue. Si ves cruces rojas, anota qué falta.
Información de la tienda: Pon nombre, actividad, país, etc.
Configuración de la base de datos: Introduce los datos que guardaste antes (nombre de la base, usuario, contraseña, servidor: normalmente localhost).
Finalizar: Crea la cuenta de administrador (email y contraseña) y haz clic en “Instalar”.

[WARNING] No cierres la pestaña durante la instalación. Puede tardar varios minutos. Si se corta, puede dejar la base de datos a medio crear.

Problemas comunes y sus soluciones

Aquí tienes una FAQ PrestaShop con los errores más frecuentes y cómo resolverlos.

1. Error “Página en blanco” o “500 Internal Server Error”

Causa: Falta de memoria PHP, extensión desactivada o archivos corruptos.
Solución:

Aumenta el límite de memoria en cPanel: Ve a “Select PHP Version” → “Switch to PHP Options” → busca memory_limit y cámbialo a 256M o 512M.
Activa extensiones: En la misma pantalla, marca curl, gd, json, mbstring, openssl, pdo_mysql, zip, xml, bcmath, intl, fileinfo.
Si usas un instalador automático, descomprime de nuevo los archivos de PrestaShop (a veces se corrompen en la subida).

2. Error “No se puede conectar a la base de datos”

Causa: Nombre de base, usuario o contraseña incorrectos, o el servidor de base de datos no es localhost.
Solución:

Revisa que en cPanel hayas creado correctamente el usuario y lo hayas añadido a la base de datos con todos los privilegios.
Prueba con 127.0.0.1 en lugar de localhost si tu hosting usa conexiones TCP.
Verifica que el nombre de la base de datos no tenga guiones o caracteres especiales (solo letras, números y guion bajo).

3. Error “La extensión PHP ‘intl’ no está disponible”

Causa: Falta la extensión intl en PHP.
Solución:

En cPanel, ve a “Select PHP Version” y activa intl en la lista de extensiones.
Si no aparece, contacta a tu proveedor de hosting para que la instale.

4. Error “La carpeta /config/ no tiene permisos de escritura”

Causa: Permisos incorrectos en archivos de PrestaShop.
Solución:

En File Manager, haz clic derecho en la carpeta raíz de PrestaShop (ej. public_html) y selecciona “Change Permissions”.
Pon 755 para carpetas y 644 para archivos. Aplica a subdirectorios.
Si el error persiste, cambia temporalmente a 777 en las carpetas config, cache, log y themes (luego vuelve a 755).

5. Error “MySQL ha alcanzado el límite de conexiones”

Causa: Muchos procesos simultáneos o un plugin que hace consultas pesadas.
Solución:

Desde cPanel, ve a “MySQL Databases” y revisa si hay muchas conexiones activas. Puedes reiniciar MySQL desde “MySQL” (si tu hosting lo permite) o contactar al soporte.
Temporalmente, aumenta el límite en el archivo my.cnf (solo si tienes acceso root, de lo contrario pide ayuda a tu hosting).

Consejos extra para una instalación exitosa

Usa un instalador automático (Softaculous)

Si prefieres no complicarte, la mayoría de los paneles cPanel incluyen Softaculous. Busca “PrestaShop” en la sección “Softaculous Apps Installer”, completa los campos y en 2 minutos tendrás tu tienda funcionando. Eso sí, asegúrate de que la versión de PHP sea compatible.

Configura PHP correctamente

Además de la memoria, revisa estos valores en “Select PHP Options”:

max_execution_time: 300 (para que no se corte la instalación).
upload_max_filesize: 32M (para subir temas o módulos).
post_max_size: 32M.

Si usas Syspanel (antes HestiaCP)

Aunque este artículo se centra en cPanel, si tu hosting usa Syspanel (el antiguo HestiaCP), el proceso es similar pero accedes por el puerto 2106 (ej. https://tudominio.com:2106). Allí encontrarás opciones para crear bases de datos y subir archivos. Los pasos de instalación de PrestaShop son idénticos.

Preguntas frecuentes (FAQ PrestaShop)

P: ¿Puedo instalar PrestaShop en un subdominio?
R: Sí, solo crea un subdominio en cPanel (sección “Subdomains”) y sube los archivos a la carpeta correspondiente (ej. public_html/tienda).

P: ¿Qué hago si la instalación se queda en el 80% y no avanza?
R: Suele ser por timeout. Aumenta max_execution_time a 300 en PHP Options y limpia la carpeta cache de PrestaShop (si ya hay archivos). Si no funciona, reinstala desde cero.

P: ¿Cómo sé qué versión de PHP tengo?
R: En cPanel, ve a “Select PHP Version” y verás la versión actual. Si es inferior a 7.4, cámbiala desde ahí.

P: ¿Es necesario tener SSL para instalar PrestaShop?
R: No es obligatorio, pero sí muy recomendable para la seguridad de tu tienda. Puedes activar SSL gratuito desde cPanel con “AutoSSL” o “Let’s Encrypt”.

P: ¿Puedo migrar una tienda PrestaShop desde otro hosting?
R: Sí, exporta la base de datos desde phpMyAdmin del origen, importa en el nuevo cPanel, y copia todos los archivos. Luego edita el archivo parameters.php con los nuevos datos de conexión.

Resumen y últimas recomendaciones

Instalar PrestaShop en cPanel no es complicado si sigues estos pasos y conoces los errores típicos. Recuerda:

Verifica los requisitos de PHP antes de empezar.
Crea la base de datos y el usuario con todos los privilegios.
Aumenta la memoria PHP si ves páginas en blanco.
Usa el instalador automático si quieres ahorrar tiempo.

Si después de todo sigues teniendo problemas, revisa los logs de error de cPanel (sección “Error Log”). Allí verás mensajes detallados que te guiarán.

[TIP] Guarda siempre una copia de seguridad de tu base de datos antes de hacer cambios importantes. En cPanel, usa “phpMyAdmin” → selecciona la base → “Exportar”.

Espero que este artículo te haya sido de gran ayuda. Si tienes más dudas, recuerda que el soporte técnico de tu hosting también puede echarte una mano. ¡Buena suerte con tu tienda online!