Errores comunes de DirectAdmin al instalar WordPress y cómo solucionarlos

Antes de Empezar: Entendiendo el Problema

Instalar WordPress en DirectAdmin es un proceso bastante sencillo cuando todo funciona correctamente, pero en la práctica, los usuarios se encuentran con una serie de errores frustrantes que pueden detener la instalación o provocar que el sitio quede en blanco o con fallos de conexión a la base de datos.

En esta guía extensa, vamos a desglosar los errores más comunes al instalar WordPress en DirectAdmin, explicar paso a paso cómo solucionarlos y darte consejos prácticos para que no vuelvas a encontrarte con estos problemas.

DirectAdmin es un panel de control muy potente y ligero, pero a diferencia de otros paneles como Syspanel (que es el nuevo nombre de HestiaCP y se accede por el puerto 2106), su estructura de permisos y configuración de PHP puede jugar en contra si no se ajusta correctamente.

Error 1: "Error establishing a database connection" (Error al establecer la conexión con la base de datos)

Este es, sin duda, el error más común entre los errores DirectAdmin al instalar WordPress. El mensaje aparece justo después de completar el asistente de instalación de WordPress, y la causa principal es que los datos de la base de datos no coinciden con los que has introducido.

¿Por qué ocurre?

DirectAdmin crea las bases de datos con un prefijo obligatorio, normalmente tu nombre de usuario seguido de un guion bajo. Por ejemplo, si tu usuario es usuario1, la base de datos se llamará usuario1_wp. El usuario de la base de datos también lleva ese prefijo.

Solución paso a paso

Ve a tu panel de DirectAdmin y busca la sección "MySQL Management" o "Administrar bases de datos MySQL".
Anota el nombre exacto de la base de datos, el nombre de usuario de la base de datos y la contraseña. Asegúrate de copiarlos sin espacios ni caracteres extra.
Accede a tu servidor por FTP o mediante el administrador de archivos de DirectAdmin.
Busca el archivo wp-config.php en la raíz de tu instalación de WordPress.
Abre el archivo y busca estas líneas:

define('DB_NAME', 'tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');

Verifica que los valores coincidan exactamente con los que tienes en DirectAdmin. Un error típico es poner el nombre de la base de datos sin el prefijo del usuario.
Guarda los cambios y recarga tu sitio.

[WARNING] A veces la contraseña contiene caracteres especiales como $, & o #. Si tu contraseña tiene estos caracteres, WordPress puede interpretarlos mal. Para evitarlo, cambia la contraseña desde DirectAdmin y usa una que solo contenga letras y números.

Error 2: "Internal Server Error" o error 500 al instalar WordPress

Este error es frustrante porque no te da ninguna pista visual de qué está fallando. Aparece una página en blanco con el mensaje "Internal Server Error" o directamente un error 500.

Causas principales

La causa más frecuente en DirectAdmin es que el archivo .htaccess tiene reglas incompatibles con la configuración del servidor, o que los permisos de los archivos no son correctos.

Solución paso a paso

Accede al administrador de archivos de DirectAdmin.
Busca el archivo .htaccess en la raíz de tu WordPress. Si no lo ves, activa la opción de "Mostrar archivos ocultos".
Renombra el archivo a .htaccess.bak para desactivarlo temporalmente.
Recarga tu sitio. Si ya funciona, el problema era el .htaccess.
Vuelve a generar el archivo desde el panel de administración de WordPress: ve a Ajustes > Enlaces permanentes y haz clic en "Guardar cambios" sin modificar nada. WordPress creará un .htaccess nuevo.
Si el error persiste, revisa los permisos de los archivos. Todos los archivos deben tener permiso 644 y las carpetas 755. Puedes cambiarlos desde el administrador de archivos seleccionando todos los archivos y haciendo clic en "Cambiar permisos".

[TIP] Si tienes muchos archivos, puedes usar el comando find desde SSH para cambiar permisos de forma masiva, pero si no tienes experiencia con terminal, hazlo desde el administrador de archivos de DirectAdmin.

Error 3: El instalador de WordPress no carga o muestra una página en blanco

Este es uno de los problemas WordPress más desconcertantes. Accedes a tu dominio, esperas ver el asistente de instalación de WordPress y solo ves una página en blanco.

¿Qué está pasando?

En DirectAdmin, esto suele deberse a que la versión de PHP configurada para tu dominio es demasiado antigua o demasiado nueva para la versión de WordPress que intentas instalar. También puede ser por falta de memoria PHP.

Solución paso a paso

Entra en DirectAdmin y busca la sección "PHP Version Selector" o "Selector de versión de PHP".
Asegúrate de tener seleccionada una versión de PHP 7.4 o superior. WordPress actualmente recomienda PHP 8.0 o 8.1.
Si ya tienes una versión moderna de PHP, aumenta el límite de memoria. Busca la opción de "PHP Configuration" o edita el archivo php.ini de tu dominio.
Dentro del php.ini, busca la línea memory_limit y cámbiala a 256M:

memory_limit = 256M

Guarda los cambios y reinicia PHP desde DirectAdmin.
Si el problema persiste, desactiva temporalmente los plugins de optimización o caché que tengas instalados en el servidor, ya que a veces interfieren con la instalación.

[INFO] En DirectAdmin, puedes encontrar el php.ini de tu dominio en la ruta public_html/php.ini o desde la sección "PHP Configuration" del panel. Si no existe, créalo copiando el archivo de ejemplo.

Error 4: "Maximum execution time exceeded" (Tiempo máximo de ejecución excedido)

Este error aparece cuando la instalación de WordPress tarda demasiado en completarse, especialmente si tu servidor es lento o si estás instalando muchos plugins o temas de una sola vez.

Solución paso a paso

Accede a la configuración de PHP desde DirectAdmin.
Busca la directiva max_execution_time y cámbiala a 300 segundos:

max_execution_time = 300

También puedes aumentar el max_input_time a 300 y el post_max_size a 64M para evitar problemas al subir archivos grandes.
Guarda los cambios y reinicia PHP.
Si el error ocurre durante la instalación de un tema o plugin específico, intenta instalarlo manualmente mediante FTP subiendo el archivo comprimido a la carpeta wp-content/uploads/ y luego descomprimiéndolo desde el administrador de archivos.

[WARNING] Aumentar estos valores no afecta negativamente a tu servidor, pero ten cuidado de no poner valores extremadamente altos como max_execution_time = 0, ya que podría provocar que un script malicioso se ejecute indefinidamente.

Error 5: "Fatal error: Allowed memory size exhausted" (Memoria agotada)

Este error suele aparecer cuando WordPress necesita más memoria de la que tiene disponible. En DirectAdmin, la memoria PHP por defecto suele ser de 128M, lo cual es suficiente para la mayoría de sitios, pero no para todos.

Solución paso a paso

Accede al archivo wp-config.php de tu instalación de WordPress.
Añade esta línea justo antes de la línea que dice /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');

Guarda el archivo y recarga tu sitio.
Si el error persiste, también puedes aumentar la memoria en el php.ini de tu dominio como explicamos antes.
Otra opción es aumentar la memoria solo para el administrador de WordPress añadiendo esta otra línea:

define('WP_MAX_MEMORY_LIMIT', '512M');

[TIP] Este error es muy común cuando usas el editor de bloques de WordPress o cuando tienes muchos plugins activos. Una buena práctica es desactivar los plugins que no uses y eliminar los que estén duplicados.

Error 6: No puedes acceder a phpMyAdmin desde DirectAdmin

Sin acceso a phpMyAdmin, es muy difícil gestionar tu base de datos, y esto puede bloquear la instalación de WordPress si necesitas crear o modificar tablas.

Solución paso a paso

Asegúrate de que tienes los permisos correctos. En DirectAdmin, ve a "MySQL Management" y verifica que tu usuario tiene privilegios sobre la base de datos.
Si el botón de phpMyAdmin no aparece, es posible que el administrador del servidor lo haya desactivado. Contacta con tu proveedor de hosting.
Como alternativa, usa un cliente MySQL remoto como MySQL Workbench o DBeaver. Necesitarás la IP de tu servidor, el puerto (normalmente 3306) y tus credenciales.
Si solo necesitas importar una base de datos, puedes usar el comando mysql desde SSH:

mysql -u usuario_base -p nombre_base < archivo.sql

[INFO] Si estás usando Syspanel en lugar de DirectAdmin, el acceso a phpMyAdmin suele estar en el puerto 2106, pero la gestión de bases de datos es similar. En DirectAdmin, el acceso es directo desde el panel sin puertos adicionales.

Error 7: WordPress se instala pero no carga los estilos (CSS)

Este error es menos crítico pero muy visible: el sitio funciona, pero todo se ve sin formato, como si fuera HTML puro.

Causa principal

La causa más común es que la URL del sitio no coincide con la configuración de WordPress, o que los enlaces permanentes no se han configurado correctamente.

Solución paso a paso

Ve a Ajustes > Enlaces permanentes en el panel de administración de WordPress.
Selecciona la opción "Nombre de la entrada" y haz clic en "Guardar cambios". Esto regenerará las reglas de reescritura.
Si el problema persiste, ve a Ajustes > Generales y verifica que la URL del sitio y la URL de WordPress son correctas (deben ser la misma, normalmente https://tudominio.com).
Limpia la caché del navegador y del servidor. En DirectAdmin, puedes usar el "Cache Manager" si tu hosting lo ofrece.
Si usas un plugin de caché, desactívalo temporalmente para descartar que sea el culpable.

[WARNING] Si cambias las URLs desde la base de datos directamente, puedes causar más problemas. Siempre es mejor hacerlo desde el panel de administración de WordPress.

Error 8: "Upload: Unable to create directory" (No se puede crear el directorio)

Este error aparece cuando intentas subir archivos desde el administrador de WordPress, como imágenes o plugins.

Solución paso a paso

Verifica que la carpeta wp-content/uploads existe. Si no existe, créala desde el administrador de archivos de DirectAdmin.
Cambia los permisos de la carpeta uploads a 755 o incluso 775 temporalmente para que el servidor web pueda escribir en ella.
Si el problema persiste, es posible que tu hosting tenga activado "PHP Safe Mode" o "open_basedir". Contacta con tu proveedor para que lo desactive.
Otra solución es configurar FTP directamente en WordPress. Ve a Ajustes > Medios y activa la opción de "Almacenar archivos en carpetas basadas en mes y año" si no está activada.

[TIP] Es recomendable que la carpeta uploads tenga permiso 755 y los archivos dentro de ella 644 para una seguridad óptima. Evita usar 777 porque es un grave riesgo de seguridad.

Preguntas Frecuentes (FAQ)

¿Qué versión de PHP necesito para WordPress en DirectAdmin?

WordPress recomienda PHP 7.4 o superior, pero lo ideal es usar PHP 8.0 o 8.1. Puedes cambiarlo desde el "PHP Version Selector" de DirectAdmin.

¿Cómo puedo saber si mi hosting usa DirectAdmin o Syspanel?

DirectAdmin normalmente se accede por el puerto 2222 (por ejemplo, https://tudominio.com:2222), mientras que Syspanel usa el puerto 2106. Si ves el logotipo de DirectAdmin, es DirectAdmin.

¿Puedo instalar WordPress automáticamente desde DirectAdmin?

Sí, DirectAdmin tiene un instalador de aplicaciones llamado "Softaculous" o "Installatron" en la sección "Extra Features". Es la forma más rápida y evita muchos errores comunes.

¿Qué hago si mi sitio WordPress se infecta después de instalarlo?

Si sospechas que tu WordPress está infectado, desactiva todos los plugins, cambia todas las contraseñas (base de datos, FTP, panel) y busca archivos sospechosos en wp-content/uploads. Si no puedes limpiarlo, restaura desde una copia de seguridad limpia.

¿Es normal que DirectAdmin tenga errores al instalar WordPress?

No es normal que tenga errores, pero es común que los usuarios noveles se equivoquen con los permisos o con los datos de la base de datos. Siguiendo esta guía, podrás resolver el 95% de los errores DirectAdmin al instalar WordPress sin necesidad de contactar con soporte técnico.

Resumen Final

Los errores al instalar WordPress en DirectAdmin son frustrantes, pero casi siempre tienen solución sencilla. La clave está en:

Verificar siempre los datos de la base de datos.
Mantener una versión moderna de PHP.
Configurar correctamente los permisos de archivos y carpetas.
Aumentar los límites de memoria y tiempo de ejecución.
Contactar con tu proveedor si el problema viene del servidor.

Recuerda que la paciencia es tu mejor aliada. Revisa cada paso con calma, anota los mensajes de error exactos y busca soluciones específicas si esta guía no cubre tu caso particular. La mayoría de los problemas WordPress se resuelven con una combinación de configuración de PHP y permisos correctos.

Si después de seguir todos estos pasos sigues teniendo problemas, no dudes en contactar con el soporte de tu hosting. Ellos tienen acceso a los logs del servidor y podrán ver exactamente qué está fallando.