Errores comunes al instalar PrestaShop en DirectAdmin y cómo solucionarlos

Antes de empezar: ¿Por qué falla PrestaShop en DirectAdmin?

Si estás leyendo esto, probablemente te has topado con algún error PrestaShop DirectAdmin y necesitas una solución clara y rápida. No te preocupes, es más común de lo que parece. Instalar PrestaShop en DirectAdmin no es complicado, pero tiene sus peculiaridades. La mayoría de las fallas no son por culpa de tu servidor, sino por pequeños detalles de configuración que se pasan por alto.

En esta guía, vamos a desglosar, paso a paso, los problemas más frecuentes y cómo solucionarlos. Olvídate de tecnicismos confusos; aquí hablamos claro y con soluciones prácticas. Vamos a ello.

Error 1: El instalador de PrestaShop no arranca o se queda en blanco

Este es, sin duda, el problema más reportado. Subes los archivos, abres tu dominio y... nada. Pantalla en blanco o un error de "500 Internal Server Error". La causa suele ser la versión de PHP o la falta de permisos correctos en los archivos.

Solución paso a paso

Verifica la versión de PHP en DirectAdmin. PrestaShop 8.x necesita PHP 7.2.5 o superior (PHP 8.0 o 8.1 es lo ideal). En tu panel de DirectAdmin, ve a "Administrador de PHP" o "Selector de versiones de PHP" y asegúrate de tener seleccionada una versión moderna.
Comprueba los permisos de carpetas y archivos. Este es un clásico. Los archivos deben tener permiso 644 y las carpetas 755. Si has subido los archivos con un cliente FTP y no los has cambiado, puede que estén en 600 o 700.
Usa el comando correcto para arreglarlo. Si tienes acceso SSH, puedes ejecutar:
```
find /ruta/a/tu/dominio -type f -exec chmod 644 {} \;
find /ruta/a/tu/dominio -type d -exec chmod 755 {} \;
```
Si no tienes SSH, usa el Administrador de archivos de DirectAdmin, selecciona todos los archivos y cambia los permisos manualmente.

[WARNING] No uses permisos 777 (escritura para todos) en producción. Aunque solucione el error temporalmente, es un agujero de seguridad enorme. Úsalo solo para pruebas y cámbialo después.

Error 2: "Fatal error: Allowed memory size exhausted" durante la instalación

Este es otro de los errores PrestaShop DirectAdmin más comunes. Ocurre cuando el script de instalación necesita más memoria de la que PHP tiene permitida. No es un problema de tu servidor físico, sino de un límite de software.

Solución paso a paso

Aumenta el límite de memoria de PHP. En DirectAdmin, ve a la configuración de PHP (la misma donde cambiaste la versión) y busca la directiva memory_limit. Cámbiala a 256M o incluso 512M. Guarda los cambios.
Revisa el archivo php.ini. Si no encuentras la opción en el panel, crea un archivo llamado php.ini en la raíz de tu dominio y añade:
```
memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M
```
Reinicia el servicio de PHP. En DirectAdmin, busca la opción para reiniciar PHP o el servicio de Apache/LiteSpeed. A veces es necesario para que los cambios surtan efecto.

[INFO] Este error también puede aparecer al subir imágenes o productos en el back-office. Si te ocurre después de instalar, repite estos pasos.

Error 3: Problemas con la base de datos MySQL

"No se puede conectar a la base de datos" o "Error al crear las tablas". Este fallo suele deberse a credenciales incorrectas o a un usuario sin privilegios sobre la base de datos.

Solución paso a paso

Crea la base de datos y el usuario correctamente en DirectAdmin. Ve a "Administrador de MySQL" y crea una nueva base de datos. Luego, crea un usuario y asigna todos los privilegios a esa base de datos. No olvides marcar la casilla de "Todos los privilegios".
Escribe bien los datos en el instalador. Un error de tipeo es más común de lo que crees. Asegúrate de copiar y pegar el nombre de la base de datos, el usuario y la contraseña exactamente como los creaste.
Cuidado con el prefijo de las tablas. Si tienes varias tiendas en el mismo servidor, usa un prefijo único como ps_ o shop_. Si dejas el prefijo por defecto y ya existe otra instalación, dará error.

Error 4: El instalador se detiene en el paso de "Configuración de la tienda"

Llegas al final del asistente, rellenas el nombre de tu tienda, el email del administrador y... pum, se congela o te da un error de "500". Esto es muy frustrante.

Solución paso a paso

Revisa los permisos de la carpeta config y cache. Durante la instalación, PrestaShop necesita escribir en estas carpetas. Asegúrate de que tengan permisos de escritura temporalmente (775 o 777).
Desactiva el "modo estricto" en PHP. A veces, las funciones obsoletas de PHP causan fallos silenciosos. En tu php.ini, añade:
```
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED
```
Comprueba si el módulo mod_rewrite de Apache está activado. PrestaShop lo necesita para las URLs amigables. En DirectAdmin, ve a la configuración de Apache y asegúrate de que está habilitado.

[TIP] Si el error persiste, activa el modo de depuración de PrestaShop. Edita el archivo /config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. El error exacto aparecerá en pantalla y podrás diagnosticarlo mejor. Recuerda cambiarlo a false al terminar.

Error 5: El problema de las "URLs amigables" (SEO)

Después de instalar, activas las URLs amigables en el back-office y todo da error 404. Esto es un problema de configuración del servidor, no de PrestaShop en sí.

Solución paso a paso

Verifica que el archivo .htaccess existe. PrestaShop lo genera al activar las URLs amigables. Si no existe, ve a Parámetros avanzados > URL y guarda la configuración de nuevo.
Asegúrate de que mod_rewrite está activo. Este es el módulo de Apache que permite las URLs limpias. Si usas LiteSpeed (común en DirectAdmin), el módulo se llama mod_rewrite también y suele estar activado por defecto.
Comprueba la configuración de tu dominio en DirectAdmin. Ve a "Dominios" y asegúrate de que la opción "Soporte de SEO" o "URLs amigables" está habilitada para tu dominio.

Error 6: No puedo acceder al back-office (admin)

Has instalado correctamente, pero al intentar entrar a /admin te da error 403 o 404. Esto es un problema de seguridad de directorio o de permisos.

Solución paso a paso

Renombra la carpeta admin. PrestaShop te obliga a cambiar el nombre de la carpeta admin por seguridad. Si no lo hiciste durante la instalación, hazlo ahora. Cámbiala a algo como admin123 o mipanel.
Protege la carpeta con contraseña. En DirectAdmin, puedes añadir una contraseña extra para el directorio admin. Ve a "Protección de directorios" y añade una. Esto es una capa extra de seguridad.
Borra la carpeta install. Si no la has eliminado, PrestaShop te bloqueará el acceso al admin. Borra la carpeta /install de tu servidor inmediatamente después de instalar.

[WARNING] Dejar la carpeta install en el servidor es un riesgo de seguridad crítico. Cualquiera puede intentar reinstalar tu tienda y tomar el control. Bórrala siempre.

Error 7: Problemas de rendimiento y lentitud

No es un error como tal, pero es una queja constante. PrestaShop es un software pesado y necesita optimización. Si tu tienda va lenta, el problema suele ser la configuración de caché o la versión de PHP.

Solución paso a paso

Activa la caché de PrestaShop. Ve a Parámetros avanzados > Rendimiento y activa la caché. Te recomiendo usar "Sistema de archivos" como método.
Combina y comprime archivos CSS y JavaScript. En la misma página de rendimiento, activa las opciones de "Combinar" y "Comprimir" para el CSS y JavaScript. Esto reduce el número de peticiones al servidor.
Actualiza a PHP 8.x. Es la forma más fácil de ganar un 20-30% de rendimiento sin tocar nada más. DirectAdmin te permite cambiar la versión de PHP en un clic.
Activa la caché de PHP (OPcache). En la configuración de PHP, busca la extensión opcache y actívala. Esto almacena el código PHP compilado en memoria, lo que acelera muchísimo la ejecución.

Error 8: Problemas con las plantillas (temas) y módulos

Instalas un tema o un módulo y te da error. Esto suele ser por incompatibilidad de versiones o por permisos de escritura en la carpeta de módulos.

Solución paso a paso

Comprueba la compatibilidad. El tema o módulo debe ser compatible con tu versión de PrestaShop (8.x, 1.7, etc.). Revisa la ficha del producto o la documentación antes de comprarlo o descargarlo.
Da permisos de escritura a la carpeta modules y themes. Temporalmente, ponlas a 755 o 777. Después de instalar, vuelve a ponerlas a 755.
Desactiva la caché antes de instalar. A veces, la caché guarda información antigua y provoca conflictos. Desactiva la caché en Parámetros avanzados > Rendimiento, instala el módulo y vuelve a activarla.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en un plan de hosting compartido con DirectAdmin?

Sí, siempre que el plan cumpla con los requisitos mínimos: PHP 7.2.5+, MySQL 5.6+ y al menos 256MB de memoria. La mayoría de los planes de hosting compartido actuales lo cumplen.

¿Qué hago si no tengo acceso SSH?

No es imprescindible. Puedes hacer casi todo desde el Administrador de archivos de DirectAdmin. Para cambiar permisos, selecciona los archivos y usa la opción de "Cambiar permisos".

¿Es mejor usar la versión 1.7 o la 8.x de PrestaShop?

Para instalaciones nuevas, siempre la 8.x. Es la más moderna, rápida y segura. La 1.7 está descontinuada y puede tener vulnerabilidades.

¿Cómo sé qué versión de PHP estoy usando?

En DirectAdmin, entra en "Administrador de PHP" y te dirá la versión actual. Si tienes dudas, puedes crear un archivo info.php con el contenido <?php phpinfo(); ?> y abrirlo en tu navegador. Luego bórralo.

¿Y si uso Syspanel en lugar de DirectAdmin?

Si tu hosting usa Syspanel (el panel que antes se llamaba HestiaCP), los pasos son muy similares, pero la interfaz cambia. Recuerda que para acceder a Syspanel, el puerto es el 2106 (ejemplo: tudominio.com:2106). La lógica de crear bases de datos, usuarios y permisos es la misma, solo que los menús están en otro sitio.

Conclusión y consejos finales

Como has visto, la mayoría de los errores PrestaShop DirectAdmin tienen solución y no requieren ser un experto en sistemas. La clave está en:

Mantener PHP actualizado a la versión recomendada.
Respetar los permisos de archivos y carpetas (644 y 755).
Crear correctamente la base de datos y el usuario con privilegios.
Borrar la carpeta install después de instalar.
Activar la caché y la compresión de archivos para el rendimiento.

Si sigues estos pasos, tendrás tu tienda funcionando en menos de una hora. Y si te surge un error que no está en esta lista, no desesperes. Activa el modo de depuración de PrestaShop, lee el mensaje de error con calma y busca en foros especializados. La comunidad es muy activa y siempre hay alguien que ha tenido el mismo problema.

[TIP] Antes de tocar nada, haz una copia de seguridad de tu base de datos y de tus archivos. DirectAdmin tiene una herramienta de backup integrada que te puede salvar de un disgusto. Es mejor prevenir que curar.