Errores al instalar WordPress en DirectAdmin y cómo solucionarlos

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

Instalar WordPress en DirectAdmin suele ser un proceso sencillo, pero no está exento de sorpresas. La mayoría de los errores wordpress directadmin no son culpa del CMS, sino de pequeños detalles de configuración del servidor, permisos incorrectos o versiones de PHP desactualizadas. Si estás leyendo esto, probablemente ya has visto una pantalla blanca, un error de conexión a la base de datos o un mensaje de "permiso denegado". No te preocupes, es más común de lo que crees y casi siempre tiene solución.

Este artículo está pensado para que, paso a paso y sin tecnicismos innecesarios, puedas identificar y resolver los fallos más frecuentes. Vamos a ello.

Error 1: "Error establishing a database connection" (No se puede conectar con la base de datos)

Este es, con diferencia, el error más habitual al instalar wordpress directadmin problemas. Aparece en una pantalla amarilla y blanca y suele deberse a tres causas: datos incorrectos en el archivo wp-config.php, la base de datos no existe o el usuario no tiene permisos.

Solución paso a paso

Revisa el archivo wp-config.php: Accede a tu panel de control de DirectAdmin, ve al administrador de archivos y navega hasta public_html. Busca el archivo wp-config.php y ábrelo para editarlo.
Verifica los datos de conexión: Asegúrate de que estos cuatro valores son exactamente los que te proporcionó tu proveedor de hosting:
- DB_NAME (nombre de la base de datos)
- DB_USER (usuario de la base de datos)
- DB_PASSWORD (contraseña de ese usuario)
- DB_HOST (normalmente es localhost, pero a veces es un host remoto como mysql.tudominio.com)
Comprueba en DirectAdmin que la base de datos existe: Entra en la sección "MySQL Management" y verifica que la base de datos y el usuario están creados. Un error típico es que el usuario no tenga todos los privilegios asignados. Marca la casilla de "ALL PRIVILEGES" y guarda.
Prueba con un script simple: Crea un archivo llamado testdb.php en public_html con este contenido:
```
<?php
$conn = new mysqli('localhost', 'TU_USUARIO', 'TU_PASSWORD', 'TU_BASE_DE_DATOS');
if ($conn->connect_error) {
    die("Conexión fallida: " . $conn->connect_error);
}
echo "Conexión correcta";
?>
```
Si al abrirlo en el navegador te dice "Conexión correcta", el problema está en tu wp-config.php. Si te da error, el problema es del servidor.

[TIP] Si tu hosting usa un host remoto para MySQL, en DirectAdmin lo verás en la sección "MySQL Management" como "Remote MySQL". Copia esa dirección exacta.

Error 2: Pantalla blanca de la muerte (WSOD)

La temida pantalla blanca puede aparecer al instalar o al actualizar. No muestra ningún mensaje, solo un fondo blanco. Las causas más comunes son un plugin incompatible, un tema con errores o un límite de memoria PHP agotado.

Solución paso a paso

Aumenta el límite de memoria PHP: Este es el arreglo más rápido y suele funcionar. Edita el archivo wp-config.php y añade esta línea justo antes de la línea que dice /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```
Desactiva todos los plugins: Si tienes acceso al administrador de archivos, renombra la carpeta public_html/wp-content/plugins a plugins_off. WordPress, al no encontrar la carpeta de plugins, los desactivará todos temporalmente. Si la página carga, el problema era un plugin.
Cambia el tema por defecto: Renombra la carpeta public_html/wp-content/themes a themes_off. WordPress usará un tema por defecto. Si la página carga, el problema era el tema.
Activa el modo debug: En wp-config.php añade:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
```
Después de recargar la página, revisa el archivo wp-content/debug.log. Ahí verás el error exacto.

[WARNING] No dejes el modo debug activado en producción. Una vez resuelto el problema, elimina esas líneas o cambia true por false.

Error 3: Errores de permisos de archivos y carpetas

Los permisos archivos wordpress son un dolor de cabeza clásico. Si ves errores como "Unable to write to wp-content/themes" o "Permission denied" al intentar subir archivos, es que los permisos están mal configurados.

Solución paso a paso

Entiende los permisos básicos: En Linux, los permisos se expresan con números. Para WordPress, la regla de oro es:
- Carpetas (directorios): 755
- Archivos: 644
- wp-config.php: 600 (por seguridad)
Usa el administrador de archivos de DirectAdmin: Selecciona todos los archivos y carpetas de public_html, haz clic derecho y elige "Change Permissions". Aplica 755 a las carpetas y 644 a los archivos.
El problema de los archivos "root": A veces, los archivos se suben como usuario root en vez del usuario del hosting. En DirectAdmin, en el administrador de archivos, verás una columna "Owner". Si no es tu usuario, tendrás que usar el comando chown desde SSH (si tienes acceso) o contactar al soporte.
Carpetas específicas que necesitan más permisos: Las carpetas wp-content/uploads, wp-content/cache y wp-content/plugins a veces necesitan permisos 775 si tu hosting usa un usuario PHP distinto. Pregunta a tu proveedor si es necesario.

[INFO] Si usas FTP, asegúrate de que tu cliente FTP esté configurado para transferir en modo "binario" y no "ASCII". Esto evita corrupción de archivos.

Error 4: Error al conectar con FTP / "To perform the requested action, WordPress needs to access your web server"

Este error aparece cuando intentas instalar un plugin o tema y WordPress te pide credenciales FTP. No es un error en sí, sino una configuración de seguridad del servidor.

Solución paso a paso

Añade la constante FS_METHOD: En el archivo wp-config.php, antes de la línea final, añade:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que use el sistema de archivos directamente, sin FTP.
Si el error persiste: Es que tu servidor no permite escritura directa. Asegúrate de que los permisos archivos wordpress son correctos (paso anterior) y que el usuario de PHP es el mismo que el propietario de los archivos.
Alternativa: Si no puedes resolverlo, instala los plugins y temas manualmente. Descarga el archivo ZIP, súbelo a wp-content/plugins/ o wp-content/themes/ y descomprímelo desde el administrador de archivos de DirectAdmin.

Error 5: "Briefly unavailable for scheduled maintenance"

Este mensaje aparece cuando WordPress está actualizándose y el proceso se interrumpe. Es frustrante porque bloquea todo el sitio.

Solución paso a paso

Elimina el archivo .maintenance: En public_html, busca un archivo llamado .maintenance. Si existe, elimínalo. Eso es todo.
Si no lo ves: Activa la opción de "Mostrar archivos ocultos" en el administrador de archivos de DirectAdmin.
Prevención: Este error suele ocurrir cuando se interrumpe una actualización. Asegúrate de tener una copia de seguridad antes de actualizar.

Error 6: "Are you sure you want to do this?" (¿Seguro que quieres hacer esto?)

Este error aparece al intentar eliminar un plugin o tema y suele estar relacionado con un problema de URL o de cookies.

Solución paso a paso

Limpia las cookies y caché del navegador: A veces es un problema temporal del navegador.
Revisa las URLs en wp-config.php: Añade estas líneas para forzar las URLs correctas:
```
define('WP_HOME', 'http://tudominio.com');
define('WP_SITEURL', 'http://tudominio.com');
```
Reemplaza tudominio.com por tu dominio real.
Desactiva plugins de caché: Si tienes un plugin de caché, desactívalo temporalmente, ya que puede interferir con las acciones de administración.

Error 7: "The uploaded file exceeds upload_max_filesize"

Este error aparece al intentar subir un plugin o tema que pesa más de lo permitido por el servidor.

Solución paso a paso

Crea un archivo .htaccess: En public_html, crea o edita el archivo .htaccess y añade:

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300

Si no funciona: El servidor puede tener límites más restrictivos. En ese caso, sube el archivo por FTP a wp-content/plugins/ y descomprímelo ahí.
Alternativa: Usa un plugin como "WP Increase Upload Limits" si tienes acceso al panel de administración.

Error 8: "Internal Server Error" (Error 500)

Este error es genérico y puede tener múltiples causas. Es un comodín que aparece cuando algo falla en el servidor.

Solución paso a paso

Revisa el archivo .htaccess: Renombra .htaccess a .htaccess_old. Si el sitio funciona, el problema está en ese archivo. Ve a Ajustes > Enlaces permanentes y haz clic en "Guardar cambios" para regenerarlo.
Aumenta la memoria PHP: Como en el Error 2, añade la línea de memoria en wp-config.php.
Revisa los logs del servidor: En DirectAdmin, ve a "Error Logs" o "Apache Error Logs". Busca la última línea de error, te dará una pista exacta.
Desactiva el tema: Si el error empezó después de cambiar de tema, renombra la carpeta del tema actual en wp-content/themes/.

Tabla rápida de diagnóstico

Error	Causa probable	Solución rápida
Conexión a BD	Datos incorrectos	Revisar wp-config.php
Pantalla blanca	Plugin/tema	Desactivar plugins
Permisos denegados	Permisos 755/644	Cambiar permisos
Pide FTP	FS_METHOD	Añadir define('FS_METHOD','direct')
Mantenimiento	.maintenance	Eliminar archivo
Error 500	.htaccess	Renombrar archivo

Preguntas frecuentes (FAQ)

¿Por qué me pide FTP si ya tengo los archivos subidos?

Es una medida de seguridad del servidor. Añade define('FS_METHOD', 'direct'); en wp-config.php para evitarlo.

¿Cuál es el permiso correcto para wp-config.php?

600. Es el más seguro. Si tienes problemas, puedes ponerlo a 644 temporalmente.

¿Debo usar 755 o 775 para las carpetas?

755 es lo estándar. Usa 775 solo si tu proveedor te lo indica, generalmente para wp-content/uploads en servidores con PHP-FPM.

¿Qué hago si no tengo acceso SSH?

No lo necesitas para la mayoría de los errores. DirectAdmin tiene un administrador de archivos completo que te permite cambiar permisos y editar archivos.

¿Es normal que aparezcan estos errores al instalar WordPress?

Sí, es muy común. La mayoría se resuelven en minutos siguiendo los pasos anteriores.

¿Puedo usar Syspanel en lugar de DirectAdmin?

Sí, Syspanel (que antes se llamaba HestiaCP) es una alternativa popular. Se accede por el puerto 2106 y tiene una interfaz similar. Los errores y soluciones de WordPress son prácticamente los mismos, solo cambia la ruta de acceso al panel de control.

¿Cómo evito estos problemas en el futuro?

Mantén WordPress, plugins y temas actualizados.
Haz copias de seguridad periódicas.
Usa un plugin de seguridad.
No instales plugins de fuentes desconocidas.

Conclusión

Resolver los errores wordpress directadmin es más fácil de lo que parece. El 80% de los problemas se solucionan con dos acciones: revisar el wp-config.php y corregir los permisos archivos wordpress. El resto es cuestión de paciencia y de seguir los pasos que hemos detallado.

Si después de probar todo sigues con problemas, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso al servidor y pueden ver logs que tú no puedes. Pero con esta guía, ya tienes el 90% del camino recorrido.

[INFO] Guarda este artículo como referencia. La próxima vez que veas un error, busca el síntoma en la tabla rápida de diagnóstico y ve directo a la solución. Te ahorrarás horas de frustración.