Errores de instalación PrestaShop en DirectAdmin: FAQ | Linux

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, probablemente estés intentando instalar una tienda online con PrestaShop en tu servidor DirectAdmin y te hayas encontrado con algún que otro dolor de cabeza. No te preocupes, es más común de lo que crees.

En esta guía, vamos a desglosar los errores más frecuentes que aparecen durante la instalación de PrestaShop en DirectAdmin, y te daré soluciones paso a paso, muy visuales y fáciles de aplicar. Al final, te dejo una sección de preguntas frecuentes (FAQ) para que resuelvas cualquier duda extra.

Vamos a ello, paso a paso.

Requisitos previos: ¿Qué necesitas antes de instalar?

Antes de lanzarte a la instalación, asegúrate de que tu servidor Linux (con DirectAdmin) cumple con los requisitos mínimos. Si no lo haces, te encontrarás con los típicos errores PrestaShop que te volverán loco.

Lo que necesitas tener listo en tu panel de DirectAdmin:

PHP 7.4 o superior (recomendado PHP 8.0 o 8.1 para mejor rendimiento).
MySQL 5.6 o superior (o MariaDB 10.1+).
Extensiones de PHP obligatorias:
- mysqli (para conexión a base de datos).
- gd (para procesar imágenes).
- curl (para conexiones externas).
- openssl (seguridad).
- mbstring (caracteres especiales).
- zip (para descomprimir archivos).
- fileinfo (para detectar tipos de archivo).
- intl (para internacionalización).
- json (para datos estructurados).
Memoria PHP: Al menos 256 MB (recomendado 512 MB).
Permisos de escritura en la carpeta donde instalas PrestaShop.

[INFO] Si tu DirectAdmin usa Syspanel (antes HestiaCP), el acceso es por el puerto 2106. Aunque no es DirectAdmin, los pasos de configuración son similares. En ese caso, verifica que Syspanel tenga las mismas extensiones habilitadas.

Error #1: "No se puede conectar a la base de datos"

Este es, con diferencia, el error más común durante la instalación de PrestaShop. Te aparece un mensaje como: "No se puede conectar a la base de datos. Compruebe su nombre de usuario, contraseña y servidor."

¿Por qué ocurre?

Los datos de la base de datos son incorrectos.
El servidor MySQL no está corriendo.
El usuario de la base de datos no tiene permisos sobre la base de datos.
El nombre del servidor de base de datos no es el correcto (a veces es localhost, otras veces es 127.0.0.1 o un socket).

Solución paso a paso:

Accede a DirectAdmin y ve a MySQL Management.
Crea una nueva base de datos y un usuario asociado. Anota el nombre de la base de datos, el usuario y la contraseña exactamente como los has escrito.
Verifica que el usuario tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). En DirectAdmin, al crear el usuario, suele asignarse automáticamente. Si no, edita los permisos.
En el instalador de PrestaShop, cuando te pida el servidor de base de datos, prueba con:
- localhost
- 127.0.0.1
- El nombre de tu servidor (a veces aparece en DirectAdmin como server.midominio.com).
Prueba desde la línea de comandos (si tienes acceso SSH) para ver si el servidor responde:
```
mysql -u tuprefijo_usuario -p -h localhost
```
Si te conecta, el problema está en los datos introducidos en el instalador.

[WARNING] No uses el usuario root de MySQL. Siempre crea un usuario específico para PrestaShop. Es más seguro y evita conflictos.

Error #2: "El archivo de configuración settings.inc.php no se puede escribir"

Este error aparece cuando PrestaShop no tiene permisos para escribir en su propio archivo de configuración. Es típico en servidores Linux con DirectAdmin.

¿Por qué ocurre?

Los permisos de la carpeta donde instalas PrestaShop no son correctos.
El usuario del servidor web (normalmente apache o nobody) no es el propietario de los archivos.

Solución paso a paso:

Accede al administrador de archivos de DirectAdmin o usa FTP.
Navega a la carpeta raíz donde has subido PrestaShop (por ejemplo, public_html o public_html/tienda).
Cambia los permisos de la carpeta config a 755 (temporalmente, durante la instalación, puedes usar 777 pero luego debes bajarlo a 755 por seguridad).
Asegúrate de que el archivo settings.inc.php (que se creará durante la instalación) tenga permisos de escritura para el grupo y el usuario del servidor web.
Si usas DirectAdmin, puedes hacerlo desde el File Manager: selecciona la carpeta config, haz clic derecho > Change Permissions y marca Write para el usuario y el grupo.
Verifica el propietario: En DirectAdmin, el propietario suele ser tu usuario. Si no, desde SSH ejecuta:
```
chown -R tuprefijo:tuprefijo public_html
```

[TIP] Si después de la instalación ves errores de permisos, es porque dejaste la carpeta config en 777. Cámbiala a 755 para evitar problemas de seguridad.

Error #3: "El límite de memoria PHP es demasiado bajo"

PrestaShop es exigente con la memoria. Si ves el error: "The memory limit is too low. The minimum required is 256M", significa que tu PHP está configurado con un límite muy bajo.

¿Por qué ocurre?

DirectAdmin a veces tiene valores por defecto muy restrictivos (como 128M o incluso 64M).
No has personalizado el archivo php.ini de tu dominio.

Solución paso a paso:

Accede a DirectAdmin > Account Manager > PHP Selector (o PHP Settings según la versión).
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios y reinicia el servicio web si es necesario (en DirectAdmin suele ser automático).
Si no tienes PHP Selector, edita manualmente el archivo php.ini de tu dominio (normalmente en public_html/php.ini). Añade o modifica esta línea:
```
memory_limit = 256M
```
Verifica el cambio creando un archivo info.php en tu carpeta raíz con este contenido:
```
<?php phpinfo(); ?>
```
Luego accede a tudominio.com/info.php y busca memory_limit. Debería mostrar 256M o superior.

[WARNING] No olvides borrar el archivo info.php después de verificar, ya que expone información sensible de tu servidor.

Error #4: "La extensión GD no está instalada"

PrestaShop necesita la extensión GD para procesar imágenes (miniaturas de productos, logos, etc.). Si ves el error: "The GD extension is not loaded", estás en el lugar correcto.

¿Por qué ocurre?

DirectAdmin no tiene habilitada la extensión GD en el PHP seleccionado.
La extensión no está instalada en el sistema.

Solución paso a paso:

Desde DirectAdmin, ve a PHP Selector (o PHP Extensions).
Busca la extensión gd y actívala (marca la casilla o selecciona "On").
Si no aparece, significa que no está instalada en el sistema. Debes pedir a tu proveedor de hosting que la instale, o si tienes acceso root, instálala desde la terminal:
```
# Para CentOS/RHEL
yum install php-gd
# Para Ubuntu/Debian
apt-get install php-gd
```

Reinicia el servidor web:

systemctl restart httpd  # Para Apache
systemctl restart nginx  # Para Nginx

Vuelve a verificar con el archivo info.php que la extensión aparece como enabled.

[INFO] En Syspanel (antiguo HestiaCP, puerto 2106), el proceso es similar: busca en el panel de administración de PHP las extensiones y activa gd. Si no aparece, contacta con soporte.

Error #5: "Error de escritura en la carpeta cache"

PrestaShop utiliza carpetas temporales para cachear datos. Si ves errores de escritura en cache, log o upload, es porque los permisos de esas carpetas no son correctos.

¿Por qué ocurre?

Las carpetas cache, log, upload y themes no tienen permisos 755 o 777.
El usuario del servidor web no puede escribir en ellas.

Solución paso a paso:

Desde el File Manager de DirectAdmin, navega a la raíz de tu instalación de PrestaShop.
Cambia los permisos de las siguientes carpetas a 755 (o 777 temporalmente durante la instalación):
- cache
- log
- upload
- themes
- img
- mails
- modules
- translations
Si ya tienes la tienda instalada, asegúrate de que los archivos dentro de estas carpetas también tengan permisos adecuados (644 para archivos, 755 para carpetas).
Desde SSH, puedes hacerlo de forma recursiva:
```
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
```
Esto aplica permisos estándar a toda la instalación.

[TIP] No dejes las carpetas en 777 después de la instalación. Es un riesgo de seguridad. Usa 755 para carpetas y 644 para archivos.

Error #6: "El archivo .htaccess no se puede generar"

PrestaShop genera automáticamente un archivo .htaccess para las URLs amigables y la seguridad. Si ves un error relacionado, es porque no tiene permisos para escribirlo.

¿Por qué ocurre?

El archivo .htaccess ya existe y no tiene permisos de escritura.
La carpeta raíz no tiene permisos 755.
ModRewrite no está habilitado en Apache.

Solución paso a paso:

Verifica que ModRewrite esté activado en DirectAdmin > Apache Configuration > Mod Rewrite. Debe estar en On.
Asegúrate de que la carpeta raíz tenga permisos 755 (no 777).
Si el archivo .htaccess ya existe, bórralo temporalmente y deja que PrestaShop lo genere de nuevo durante la instalación.
Después de la instalación, puedes personalizar el .htaccess para reglas de SEO, pero asegúrate de que los permisos sean 644.

[WARNING] No edites el .htaccess generado por PrestaShop a menos que sepas lo que haces. Un error puede romper toda la tienda.

Error #7: "El instalador se queda colgado en el paso 3 o 4"

A veces, el instalador de PrestaShop se queda cargando infinitamente en pasos como "Configuración de la tienda" o "Instalación de módulos". Esto suele deberse a tiempos de ejecución de PHP demasiado bajos.

¿Por qué ocurre?

El límite de tiempo de ejecución (max_execution_time) es muy bajo (por defecto 30 segundos).
Hay muchos módulos que instalar o la conexión a la base de datos es lenta.

Solución paso a paso:

Aumenta el max_execution_time en el php.ini de tu dominio a 300 (5 minutos) o más.
```
max_execution_time = 300
```
Aumenta también max_input_time a 300.
Reinicia el servidor web si es necesario.
Vuelve a intentar la instalación. Si sigue colgado, prueba a instalar PrestaShop en modo manual (subiendo los archivos y ejecutando el script de instalación desde la línea de comandos, pero eso es más avanzado).

[TIP] Si tu hosting es muy básico, considera instalar una versión anterior de PrestaShop (1.7.8 en lugar de 8.x) que es menos exigente.

FAQ: Preguntas frecuentes sobre errores de instalación de PrestaShop en DirectAdmin

1. ¿Puedo instalar PrestaShop en un subdominio con DirectAdmin?

Sí, perfectamente. Simplemente crea un subdominio en DirectAdmin y sube los archivos de PrestaShop a la carpeta de ese subdominio. Los pasos de instalación son idénticos.

2. ¿Qué hago si no veo el PHP Selector en mi DirectAdmin?

Algunos planes de hosting no incluyen el PHP Selector. En ese caso, debes editar el archivo php.ini manualmente a través del File Manager o pedir a tu proveedor que ajuste los valores. También puedes crear un archivo .user.ini en la raíz con las directivas que necesites.

3. ¿Es necesario tener acceso SSH para solucionar estos errores?

No, la mayoría de los errores se solucionan desde el panel de DirectAdmin (File Manager, MySQL Management, PHP Selector). El acceso SSH solo es necesario para casos muy específicos (como instalar extensiones de PHP a nivel de sistema).

4. ¿Por qué mi instalación de PrestaShop se ve en blanco después de la instalación?

Esto suele ser por un error de PHP no mostrado. Activa la visualización de errores temporalmente añadiendo al archivo config/defines.inc.php la línea:

define('_PS_MODE_DEV_', true);

Así verás el error real (normalmente un problema de permisos o de extensión de PHP faltante).

5. ¿Puedo usar MariaDB en lugar de MySQL?

Sí, PrestaShop funciona perfectamente con MariaDB. De hecho, es recomendable por su rendimiento. Solo asegúrate de que la versión sea 10.1 o superior.

6. ¿Qué hago si el error persiste después de seguir todos los pasos?

Si has seguido todos los pasos y el error sigue apareciendo, puede ser un problema de configuración del servidor a nivel de sistema. Contacta con tu proveedor de hosting y explícales que necesitas instalar PrestaShop y que requieres las extensiones PHP mencionadas y permisos de escritura.

Conclusión: ¡Tu tienda online está a punto de nacer!

Instalar PrestaShop en DirectAdmin puede parecer complicado al principio, pero con esta guía detallada y paso a paso, los errores PrestaShop más comunes dejarán de ser un problema. Recuerda:

Verifica siempre los requisitos antes de empezar.
Los permisos de archivos y carpetas son la causa del 80% de los errores.
Usa el PHP Selector para ajustar memoria, tiempo de ejecución y extensiones.
Si algo falla, revisa el archivo de logs de PrestaShop (en la carpeta log).

Y si eres usuario de Syspanel (recuerda, el puerto 2106), los pasos son muy similares, solo cambia la interfaz del panel