Errores instalación WordPress en DirectAdmin: soluciones

Instalar WordPress en un servidor con panel DirectAdmin debería ser un proceso sencillo, pero a menudo nos encontramos con obstáculos que pueden desanimar a cualquiera. Si estás viendo pantallas en blanco, errores de conexión a la base de datos o mensajes de permisos denegados, no te preocupes. En esta guía extensa y muy práctica, vamos a desglosar los errores comunes al instalar WordPress en DirectAdmin y, lo más importante, cómo solucionarlos paso a paso.

Este artículo está diseñado para que lo entiendas aunque no seas un experto técnico. Vamos a usar un lenguaje claro, con ejemplos y consejos directos. Al final, serás capaz de resolver por ti mismo la mayoría de los problemas que hacen que una instalación fallida WordPress se convierta en un dolor de cabeza.

1. El Error Más Frecuente: Permisos de Archivos Incorrectos

Uno de los motivos más habituales por los que WordPress no funciona después de instalarlo es tener los permisos archivos WordPress mal configurados. Esto provoca que no puedas subir imágenes, instalar plugins o incluso que veas un error 403 (Prohibido) o 500 (Error interno del servidor).

¿Por qué ocurre?

DirectAdmin, por seguridad, asigna unos permisos base a los archivos y carpetas que creas. Si al subir WordPress manualmente o mediante el instalador automático (Softaculous, Installatron) estos permisos se rompen, el servidor no deja que WordPress escriba o lea los archivos necesarios.

Solución paso a paso:

Accede a tu panel de DirectAdmin.
Ve a la sección "Administrador de Archivos" (File Manager).
Navega hasta la carpeta donde instalaste WordPress (normalmente public_html o una subcarpeta como public_html/blog).
Selecciona todos los archivos y carpetas (Ctrl + A o Cmd + A).
Haz clic en el botón "Cambiar permisos" (suele ser un icono con un candado o una llave).
En la ventana que aparece, establece los siguientes valores:
- Carpetas (Directorios): 755 (rwxr-xr-x).
- Archivos: 644 (rw-r--r--).
Marca la opción "Recursivo" (para que se aplique a todas las subcarpetas y archivos).
Haz clic en "Guardar".

[TIP] Si después de esto sigues teniendo problemas para instalar plugins o temas, cambia temporalmente la carpeta wp-content a 755. Esto permite que WordPress descargue e instale actualizaciones. Vuelve a ponerlo en 755 solo durante la instalación y luego revierte a 755 para las carpetas y 644 para los archivos.

2. Problemas con la Base de Datos: El Clásico "Error al conectar con la base de datos"

Este error es otro de los grandes culpables de una instalación fallida WordPress. Aparece cuando WordPress no puede comunicarse con MySQL o MariaDB.

Causas comunes:

Nombre de la base de datos, usuario o contraseña incorrectos en el archivo wp-config.php.
El usuario de la base de datos no tiene permisos sobre la base de datos.
El servidor de base de datos está caído o no responde.

Solución detallada:

Verifica los datos en DirectAdmin:
- Ve a la sección "MySQL Management" (o "Bases de datos MySQL").
- Anota exactamente el nombre de la base de datos, el nombre de usuario y la contraseña. En DirectAdmin, a menudo se añade un prefijo con tu nombre de usuario (ej: midomi_bdwordpress).
Revisa el archivo wp-config.php:
- Usa el Administrador de Archivos para abrir el archivo wp-config.php en la raíz de tu WordPress.
- Busca las líneas:
```
define('DB_NAME', 'aqui_tu_nombre_bd');
define('DB_USER', 'aqui_tu_usuario_bd');
define('DB_PASSWORD', 'aqui_tu_contraseña');
define('DB_HOST', 'localhost');
```
- Asegúrate de que coincidan EXACTAMENTE con lo que tienes en DirectAdmin. Un error común es copiar un espacio extra o una letra mal.
Asigna permisos al usuario:
- En la misma sección de MySQL, busca la opción para "Gestionar privilegios" de tu usuario.
- Marca la casilla "Todos los privilegios" y guarda.
Prueba la conexión:
- Si todo lo anterior está bien, pero el error persiste, el problema puede ser el servidor. Contacta a tu proveedor de hosting para que verifique que MySQL esté funcionando.

[WARNING] Nunca uses localhost como DB_HOST si tu hosting usa un servidor de base de datos externo. En DirectAdmin, lo normal es que sea localhost, pero algunos planes compartidos pueden usar una dirección IP o un nombre como mysql.tudominio.com. Consulta con tu soporte si no estás seguro.

3. El Instalador Automático No Funciona: Softaculous o Installatron Dan Error

Muchos usuarios confían en los instaladores automáticos de DirectAdmin (Softaculous o Installatron). A veces, estos fallan y dejan una instalación a medias.

¿Qué hacer si el instalador falla?

Limpia la instalación fallida:
- Ve al Administrador de Archivos y elimina todos los archivos y carpetas que el instalador haya creado en el directorio de destino.
- Ve a "MySQL Management" y elimina la base de datos y el usuario que creó el instalador.
Reintenta la instalación manual:
- Descarga WordPress desde wordpress.org.
- Descomprime el archivo en tu computadora.
- Sube todo el contenido de la carpeta wordpress a tu directorio de destino (por ejemplo, public_html) usando el Administrador de Archivos de DirectAdmin o un cliente FTP (como FileZilla).
Sigue el proceso de instalación manual:
- Abre tu navegador y ve a tudominio.com/wp-admin/install.php.
- Sigue los pasos. El proceso manual es más fiable y te da control total.

[INFO] Si tienes un servidor con Syspanel (el antiguo HestiaCP), recuerda que el acceso a tu panel se realiza a través del puerto 2106 (ejemplo: tudominio.com:2106). El proceso de instalación manual es muy similar al de DirectAdmin, pero la ubicación de los archivos puede variar ligeramente.

4. Error de Memoria Límite o "Allowed memory size exhausted"

Este es un error muy común cuando intentas instalar un tema o plugin pesado, o cuando tu WordPress tiene muchas funciones. Aparece un mensaje como: Fatal error: Allowed memory size of 268435456 bytes exhausted.

Soluciones:

Aumenta el límite de memoria en wp-config.php:
- Abre el archivo wp-config.php.
- Justo antes de la línea /* That's all, stop editing! Happy publishing. */, añade esta línea:
```
define('WP_MEMORY_LIMIT', '256M');
```
- Guarda el archivo. Esto le da a WordPress más memoria para trabajar.
Aumenta el límite en el archivo .htaccess:
- Abre el archivo .htaccess en la raíz de tu WordPress (si no existe, créalo).
- Añade estas líneas al principio:
```
php_value memory_limit 256M
php_value upload_max_filesize 64M
php_value post_max_size 64M
```
- Guarda el archivo.
Contacta a tu hosting:
- Si los pasos anteriores no funcionan, es posible que tu plan de hosting tenga un límite muy bajo. Pregunta a tu proveedor si pueden aumentarlo desde el servidor.

5. Problemas con el Archivo `.htaccess` y los Enlaces Permanentes

Después de instalar WordPress, al intentar cambiar la estructura de los enlaces permanentes (por ejemplo, a /%postname%/), todo deja de funcionar y ves errores 404.

Solución:

Haz que WordPress pueda escribir en .htaccess:
- Temporalmente, cambia los permisos del archivo .htaccess a 666 (rw-rw-rw-). Esto permite que WordPress lo modifique.
- Ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress.
- Elige la estructura que quieras y haz clic en "Guardar cambios".
- Vuelve a cambiar los permisos de .htaccess a 644 por seguridad.

Si no funciona, edítalo manualmente:

Abre el archivo .htaccess con el Administrador de Archivos.

Pega este código:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Guarda y vuelve a intentar cambiar los enlaces permanentes desde el escritorio.

6. Error de "FTP Connection" al Instalar Plugins o Temas

Este error aparece cuando WordPress no puede escribir directamente en el sistema de archivos y pide credenciales FTP.

Causa y solución:

Problema de permisos del servidor: El usuario del servidor web (normalmente nobody o www-data) no tiene permisos para escribir en las carpetas de WordPress.
Solución rápida: Añade esta línea a tu archivo wp-config.php:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que intente escribir directamente, sin usar FTP. Si funciona, es porque el problema era de permisos, que ya solucionaste en el punto 1.

7. Preguntas Frecuentes (FAQ) sobre Errores en WordPress en DirectAdmin

¿Por qué veo una página en blanco después de instalar WordPress?

Esto suele deberse a un error de PHP. Activa la depuración en wp-config.php añadiendo:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Luego, revisa el archivo wp-content/debug.log para ver el error exacto.

¿Qué hago si el instalador automático de DirectAdmin no me deja elegir la versión de PHP?

En DirectAdmin, puedes cambiar la versión de PHP desde la sección "PHP Selector" o "PHP Version". Asegúrate de usar PHP 7.4 o superior para WordPress.

¿Cómo soluciono el error "429 Too Many Requests" al instalar plugins?

Esto es un límite de velocidad de tu hosting. Espera unos minutos y vuelve a intentarlo. Si es recurrente, contacta a tu proveedor.

¿Puedo instalar WordPress en una subcarpeta?

Sí, solo asegúrate de que la base de datos y los archivos estén en la ruta correcta. Por ejemplo, si lo pones en public_html/tienda, accederás a tudominio.com/tienda.

Conclusión Final

Instalar WordPress en DirectAdmin no tiene por qué ser una pesadilla. La mayoría de los errores WordPress DirectAdmin se reducen a tres cosas: permisos de archivos, configuración de la base de datos y límites de memoria. Siguiendo los pasos de esta guía, podrás resolver el 90% de los problemas que impiden que tu WordPress no instala correctamente.

Recuerda siempre:

Verifica los permisos (755 para carpetas, 644 para archivos).
Revisa tres veces los datos de la base de datos.
Aumenta la memoria si ves errores de límite.
No temas a la instalación manual; es más fiable que los instaladores automáticos.

Si después de todo sigues atascado, no dudes en contactar al soporte técnico de tu hosting. Diles exactamente qué error ves y qué pasos has seguido. ¡Buena suerte con tu sitio!