Errores instalación WordPress en DirectAdmin y soluciones

¿Te ha pasado que al intentar instalar WordPress en tu panel DirectAdmin todo parece ir bien hasta que ves una página en blanco, un error de conexión a la base de datos o un mensaje de "Error estableciendo conexión a la base de datos"? Tranquilo, es más común de lo que crees. En este artículo vamos a desglosar los errores más frecuentes al instalar WordPress en DirectAdmin y, lo más importante, cómo solucionarlos paso a paso.

Instalar WordPress es el primer paso para montar tu web, pero a veces pequeños detalles pueden convertirse en un dolor de cabeza. Aquí te explicaré desde los problemas con los permisos de archivos hasta los conflictos con versiones de PHP, pasando por errores de configuración de la base de datos. Todo explicado de forma sencilla y directa.

Al final de esta guía, no solo sabrás cómo instalar WordPress DirectAdmin error tras error, sino que también aprenderás a prevenirlos. Vamos a ello.

1. Error de conexión a la base de datos (Database Connection Error)

Este es, sin duda, el error más común. Aparece cuando WordPress no puede comunicarse con la base de datos MySQL. Las causas pueden ser varias, pero las más frecuentes son:

1.1. Datos incorrectos en wp-config.php

Al instalar WordPress, el archivo wp-config.php contiene los datos de acceso a la base de datos. Si has escrito mal el nombre de la base de datos, el usuario o la contraseña, verás este error.

Solución: Revisa el archivo wp-config.php en la raíz de tu instalación. Busca estas líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

Asegúrate de que coincidan exactamente con los datos que creaste en DirectAdmin. Un error muy típico es poner localhost cuando el servidor usa un host diferente (como mysql.tudominio.com). Si no estás seguro, consulta con tu proveedor de hosting o revisa la sección de MySQL en DirectAdmin.

1.2. Base de datos no creada o mal asignada

A veces, en DirectAdmin, creas la base de datos pero olvidas asignarle un usuario. Sin un usuario con permisos, WordPress no podrá conectarse.

Solución: Ve a MySQL Management en DirectAdmin. Verifica que la base de datos exista y que tenga al menos un usuario asignado con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, crea un nuevo usuario y asígnalo a la base de datos.

[WARNING] No uses el usuario root de MySQL. Siempre crea un usuario específico para cada base de datos.

1.3. Puerto de MySQL no estándar

Algunos servidores usan un puerto diferente al 3306 para MySQL. Si tu wp-config.php solo pone localhost, puede que no funcione.

Solución: Prueba a cambiar DB_HOST por localhost:3307 o el puerto que te indique tu hosting. También puedes usar la IP del servidor, como 127.0.0.1.

2. Página en blanco (White Screen of Death)

La temida pantalla en blanco. No muestra ningún error, solo un fondo blanco. Esto suele deberse a un error de PHP, a veces por un plugin o tema incompatible, pero también por una mala configuración del servidor.

2.1. Límite de memoria PHP insuficiente

WordPress necesita un mínimo de memoria para funcionar. Si el límite es muy bajo (por ejemplo, 32M), puede dar la pantalla en blanco.

Solución: Aumenta el límite de memoria. Puedes hacerlo editando el archivo wp-config.php y añadiendo esta línea antes de /* That's all, stop editing! */:

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

También puedes pedir a tu hosting que aumente el límite global en el php.ini.

2.2. Error en el archivo .htaccess

Si el archivo .htaccess está corrupto o tiene reglas incorrectas, WordPress no se carga.

Solución: Renombra el archivo .htaccess a .htaccess_old y luego ve a Ajustes > Enlaces permanentes en tu wp-admin (si puedes acceder) y guarda los cambios para regenerarlo. Si no puedes acceder, crea un nuevo .htaccess vacío.

2.3. Plugin o tema conflictivo

A veces, al instalar un plugin o tema, algo sale mal y la web se queda en blanco.

Solución: Desactiva todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old. Si la web vuelve a funcionar, reactiva uno por uno para encontrar el culpable. Para temas, cambia a un tema por defecto (Twenty Twenty-Four) renombrando la carpeta del tema actual.

[TIP] Si no puedes acceder al panel de administración, usa FTP o el gestor de archivos de DirectAdmin para hacer estos cambios.

3. Error 500 Internal Server Error

Este error genérico puede deberse a muchas causas, pero en DirectAdmin suele estar relacionado con permisos de archivos o con el archivo .htaccess.

3.1. Permisos incorrectos en archivos y carpetas

WordPress necesita permisos específicos para funcionar. Los archivos deben tener permiso 644 y las carpetas 755. Si tienes permisos 777 (escritura para todos), el servidor puede bloquear la web por seguridad.

Solución: Conecta por FTP o usa el gestor de archivos de DirectAdmin. Selecciona toda la carpeta de WordPress y cambia los permisos de forma recursiva:

Archivos: 644
Carpetas: 755

3.2. Archivo .htaccess dañado

Como en el caso anterior, un .htaccess con errores puede dar error 500.

Solución: Renómbralo y luego regenera los enlaces permanentes desde el panel de administración.

3.3. Versión de PHP incompatible

WordPress requiere PHP 7.4 o superior (recomendado 8.0+). Si tu DirectAdmin usa una versión antigua, tendrás problemas.

Solución: Cambia la versión de PHP para tu dominio. En DirectAdmin, ve a PHP Version Selector y elige una versión moderna (8.1 o 8.2). Guarda los cambios.

[INFO] Si usas Syspanel (antes HestiaCP), el puerto de acceso es el 2106. Allí también puedes cambiar la versión de PHP desde la sección de dominios.

4. Error "Headers already sent" o "Cannot modify header information"

Este error aparece cuando hay un espacio o un carácter extra antes de <?php o después de ?> en algún archivo de WordPress, generalmente en wp-config.php o en functions.php.

4.1. Espacios en blanco al inicio o final del archivo

Al editar wp-config.php con un editor de texto, a veces se cuelan espacios o líneas en blanco.

Solución: Abre el archivo con un editor como Notepad++ o Sublime Text y asegúrate de que no haya nada antes de <?php ni después de ?>. Lo ideal es que wp-config.php no tenga la etiqueta de cierre ?> al final, para evitar este problema.

4.2. BOM (Byte Order Mark) en archivos

Algunos editores añaden un carácter invisible al principio del archivo.

Solución: Guarda el archivo sin BOM (UTF-8 sin BOM). En Notepad++, ve a Codificación > Convertir a UTF-8 sin BOM.

5. Problemas con la instalación automática (Softaculous, Installatron)

Muchos hosting con DirectAdmin incluyen instaladores automáticos. Aunque son cómodos, a veces fallan.

5.1. Error de permisos durante la instalación

El instalador puede no tener permisos para escribir en la carpeta de destino.

Solución: Asegúrate de que la carpeta donde quieres instalar WordPress tenga permisos 755 y sea propiedad del usuario correcto. En DirectAdmin, puedes verificar esto en el gestor de archivos.

5.2. Base de datos no creada automáticamente

A veces el instalador crea la base de datos pero no asigna el usuario correctamente.

Solución: Ve a MySQL Management y verifica que la base de datos y el usuario existan. Si no, créalos manualmente y luego edita wp-config.php con esos datos.

5.3. Versión de WordPress desactualizada

Los instaladores automáticos a veces ofrecen versiones antiguas.

Solución: Siempre que puedas, descarga WordPress desde wordpress.org e instálalo manualmente. Es más seguro y evitas problemas de compatibilidad.

[TIP] Si usas instalación manual, descomprime el zip en la carpeta de tu dominio (por ejemplo, public_html) y luego sigue los pasos clásicos.

6. Error al subir archivos (límite de tamaño)

Al intentar subir un tema o plugin, WordPress te dice que el archivo es demasiado grande.

6.1. Límite de subida en PHP

El límite por defecto suele ser 2MB o 8MB.

Solución: Aumenta el límite editando el php.ini o usando el selector de PHP en DirectAdmin. Busca estas líneas y cámbialas:

upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Si no puedes editarlas, pide a tu hosting que lo haga.

6.2. Límite en el servidor web

A veces el servidor web (Apache/Nginx) también tiene un límite.

Solución: Si usas Nginx, puede que necesites añadir client_max_body_size 64M; en la configuración. En DirectAdmin, esto se hace desde el panel o contactando al soporte.

7. Error de SSL/HTTPS (contenido mixto)

Si instalaste WordPress con HTTP y luego activaste SSL, puedes ver un candado roto o errores de contenido mixto.

7.1. URL del sitio no actualizada

WordPress guarda las URLs en la base de datos. Si cambias de HTTP a HTTPS, las URLs internas siguen siendo HTTP.

Solución: Ve a Ajustes > Generales en el panel de administración y cambia las URLs de http:// a https://. Si no puedes acceder, edita wp-config.php y añade:

define('WP_HOME', 'https://tudominio.com');
define('WP_SITEURL', 'https://tudominio.com');

7.2. Redirección incorrecta en .htaccess

A veces el .htaccess no redirige bien de HTTP a HTTPS.

Solución: Añade estas reglas al principio del .htaccess:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

[WARNING] Haz una copia de seguridad del .htaccess antes de modificarlo.

8. Error de conexión FTP al instalar temas/plugins

WordPress pide credenciales FTP cada vez que intentas instalar algo. Esto es molesto y suele deberse a permisos incorrectos.

8.1. Permisos de la carpeta wp-content

Si la carpeta wp-content no es propiedad del usuario del servidor web, WordPress no puede escribir directamente.

Solución: Cambia el propietario de la carpeta wp-content y sus subcarpetas al usuario del servidor web (normalmente www-data o nobody). En DirectAdmin, esto se hace desde el gestor de archivos o por SSH.

8.2. Definir método de conexión directa

Puedes evitar el FTP añadiendo esta línea a wp-config.php:

define('FS_METHOD', 'direct');

Esto le dice a WordPress que use el sistema de archivos directamente, sin FTP.

9. Problemas con la memoria caché del navegador

A veces haces cambios en WordPress pero no se ven reflejados. El navegador guarda una versión en caché.

Solución: Limpia la caché de tu navegador (Ctrl+F5 en Windows, Cmd+Shift+R en Mac). También puedes usar el modo incógnito para probar.

[INFO] Si tu hosting usa caché de servidor (como Varnish), puede que necesites purgarla desde el panel de control.

10. Error al migrar WordPress desde otro hosting

Si ya tenías WordPress en otro lado y lo mueves a DirectAdmin, pueden aparecer errores.

10.1. Cambio de URLs en la base de datos

Al exportar la base de datos, las URLs antiguas siguen ahí.

Solución: Usa un plugin como Better Search Replace o edita directamente el SQL con un editor de texto, reemplazando http://antiguodominio.com por https://nuevodominio.com.

10.2. Archivos de configuración obsoletos

El wp-config.php puede tener datos del hosting anterior.

Solución: Crea un nuevo wp-config.php con los datos de tu nueva base de datos en DirectAdmin.

10.3. Compatibilidad de versiones de PHP

El hosting anterior podía tener PHP 7.2 y el nuevo PHP 8.2. Algunos plugins o temas antiguos no son compatibles.

Solución: Antes de migrar, actualiza todo (WordPress, temas y plugins) a las últimas versiones. Si algún plugin no es compatible, busca alternativas.

[TIP] Siempre haz una copia de seguridad completa (archivos y base de datos) antes de migrar.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error establishing a database connection" en DirectAdmin?

Generalmente por datos incorrectos en wp-config.php, base de datos no creada o usuario sin permisos. Revisa paso a paso la sección 1 de este artículo.

¿Cómo cambiar la versión de PHP en DirectAdmin?

Ve a PHP Version Selector en tu panel de DirectAdmin, selecciona la versión deseada (8.1 o 8.2) y guarda. Si usas Syspanel (puerto 2106), la opción está en la configuración del dominio.

¿Qué hago si la instalación automática falla?

Prueba la instalación manual: descarga WordPress, súbelo por FTP, crea la base de datos manualmente y edita wp-config.php. Es más fiable.

¿Cómo solucionar el error 500 en WordPress?

Revisa permisos de archivos (644 archivos, 755 carpetas), renombra .htaccess y verifica la versión de PHP. Si persiste, desactiva todos los plugins.

¿Por qué no puedo subir archivos grandes a WordPress?

Aumenta upload_max_filesize y post_max_size en el PHP Selector de DirectAdmin. Si no funciona, contacta al soporte.

Conclusión

Instalar WordPress en DirectAdmin no tiene por qué ser un dolor de cabeza. La mayoría de los errores WordPress DirectAdmin se deben a pequeños descuidos: permisos incorrectos, datos mal escritos o versiones de PHP desactualizadas. Con esta guía, ya tienes las herramientas para identificar y solucionar cada problema.

Recuerda siempre hacer copias de seguridad antes de hacer cambios importantes. Y si te encuentras con un error que no está en esta lista, no dudes en consultar los foros de soporte de WordPress o el de tu hosting. La comunidad siempre está dispuesta a ayudar.

Ahora, ¡manos a la obra! Tu web te está esperando.