🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes al instalar WordPress en Linux y cómo solucionarlos

Actualizado el 15 de diciembre de 2025

Instalar WordPress en un servidor Linux es, en teoría, un proceso sencillo. Sin embargo, la realidad es que surgen problemas con frecuencia, especialmente si estás empezando o si tu proveedor de hosting usa cPanel o paneles de control alternativos como Syspanel (HestiaCP). Los errores más comunes suelen estar relacionados con permisos de archivos, configuración de la base de datos o problemas con el servidor web.

Este artículo está diseñado para ser tu guía de primeros auxilios. Vamos a repasar los errores WordPress Linux más habituales, entender por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. No necesitas ser un experto en sistemas, solo seguir estas instrucciones al pie de la letra.

1. Error de Conexión a la Base de Datos: «Error establishing a database connection»

Este es, sin duda, el error más temido y común durante la instalación WordPress problemas. Aparece cuando WordPress no puede comunicarse con MySQL o MariaDB.

¿Por qué ocurre?

  • El nombre de la base de datos, el usuario o la contraseña son incorrectos en el archivo wp-config.php.
  • El servidor de base de datos no está funcionando (aunque es raro en hosting compartido).
  • El usuario de la base de datos no tiene permisos para acceder a la base de datos.

Cómo solucionarlo

  1. Verifica los datos en wp-config.php: Accede a tu servidor por FTP o desde el administrador de archivos de cPanel o Syspanel. Busca el archivo wp-config.php en la raíz de tu instalación. Ábrelo y comprueba estas líneas:

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

    Asegúrate de que coincidan exactamente con los datos que creaste en el panel de control.

  2. Prueba la conexión desde phpMyAdmin: En cPanel busca «phpMyAdmin»; en Syspanel (puerto 2106) busca «Base de datos» y luego «phpMyAdmin». Intenta iniciar sesión con el usuario y contraseña de la base de datos. Si no puedes, el problema está en las credenciales.

  3. Revisa el servidor de base de datos (DB_HOST): En la mayoría de los casos es localhost, pero algunos hosts usan una dirección IP o un nombre como mysql.tudominio.com. Si no estás seguro, consulta el soporte de tu hosting.

  4. Repara la base de datos: Si la conexión funciona pero el error persiste, añade esta línea en wp-config.php justo antes del comentario final:

    define('WP_ALLOW_REPAIR', true);

    Luego visita tudominio.com/wp-admin/maint/repair.php. Sigue las instrucciones y, cuando termines, elimina esa línea.

[WARNING] No dejes la línea WP_ALLOW_REPAIR activa, ya que cualquiera podría reparar (y dañar) tu base de datos.

2. El Infame «Error 500 – Internal Server Error»

Este error es genérico y puede tener muchas causas. Es frustrante porque no te dice exactamente qué falla.

Causas comunes

  • Un plugin o tema incompatible.
  • Límite de memoria de PHP insuficiente.
  • Un archivo .htaccess corrupto.
  • Permisos de archivos incorrectos.

Cómo solucionarlo paso a paso

  1. Desactiva todos los plugins: Si puedes acceder al panel de administración de WordPress, ve a Plugins y desactívalos todos. Si no puedes, renombra la carpeta wp-content/plugins desde FTP o el administrador de archivos a wp-content/plugins_old. Esto forzará la desactivación de todos.

  2. Cambia al tema por defecto: Si el error persiste, renombra la carpeta del tema activo en wp-content/themes/. WordPress usará automáticamente el tema por defecto (Twenty Twenty-Four o similar).

  3. Aumenta el límite de memoria de PHP: Edita el archivo wp-config.php y añade esta línea antes de la línea final:

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

  4. Restaura el .htaccess por defecto: Renombra el archivo .htaccess a .htaccess_old. Ve a Ajustes > Enlaces permanentes en tu panel de WordPress (si puedes acceder) y haz clic en «Guardar cambios» para regenerarlo. Si no puedes, crea uno nuevo con este contenido:

    # 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

  5. Revisa los registros de error: En cPanel busca «Registros de errores» o «Error Log». En Syspanel, puedes ver los logs del servidor web en /var/log/nginx/error.log o /var/log/apache2/error.log. Busca la línea que coincida con la hora del error. Te dará una pista más concreta.

[TIP] Si el error 500 aparece solo en una página específica, es casi seguro que es un plugin o tema. Si aparece en todo el sitio, suele ser el .htaccess o la memoria.

3. Problemas con los Enlaces Permanentes (Permalinks)

Configuras los enlaces permanentes a «Nombre de la entrada» y, al guardar, todo funciona, pero al hacer clic en una entrada obtienes un error 404.

¿Por qué ocurre?

  • El módulo mod_rewrite de Apache no está activado.
  • El archivo .htaccess no tiene permisos de escritura.
  • Estás usando Nginx y no has configurado las reglas de reescritura.

Cómo solucionarlo

  1. En Apache (cPanel o similar):

    • Ve al administrador de archivos y asegúrate de que el archivo .htaccess existe y tiene permisos 644.
    • Si no existe, créalo con el contenido del punto 4 de la sección anterior.
    • Ve a Ajustes > Enlaces permanentes en WordPress, selecciona «Nombre de la entrada» y haz clic en «Guardar cambios». Esto regenera las reglas.

  2. En Nginx (Syspanel):

    • Syspanel usa Nginx de forma predeterminada. Debes añadir reglas de reescritura en el archivo de configuración del sitio.
    • Accede a Syspanel (puerto 2106) > Web > tu dominio > Configuración avanzada.
    • En el campo «Reglas de reescritura» o «Ubicación», pega lo siguiente: 
      location / {
    try_files $uri $uri/ /index.php?$args;
}
    • Guarda y recarga Nginx desde el panel.

[INFO] Si tu hosting usa Syspanel, recuerda que el puerto de acceso es el 2106. Allí podrás gestionar toda la configuración del servidor web.

4. El Clásico «White Screen of Death» (WSOD) o Pantalla en Blanco

Abres tu sitio y solo ves un fondo blanco. Sin mensajes, sin nada.

Causas

  • Un error fatal de PHP (sintaxis incorrecta en un archivo).
  • Un plugin o tema defectuoso.
  • Límite de memoria agotado.

Solución

  1. Activa el modo de depuración de WordPress: Edita wp-config.php y añade:

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

    Esto creará un archivo debug.log dentro de la carpeta wp-content/. Ábrelo para ver el error exacto.

  2. Desactiva todo manualmente: Como en el error 500, renombra las carpetas plugins y themes para aislar el problema.

  3. Aumenta la memoria: Añade la línea de WP_MEMORY_LIMIT que vimos antes.

  4. Comprueba la sintaxis de PHP: Si editaste algún archivo manualmente (como functions.php), es posible que hayas dejado un punto y coma o una llave mal puesta. Revisa el archivo con un editor de código.

5. Error de Permisos de Archivos y Carpetas

Después de instalar, no puedes subir imágenes o plugins, o ves mensajes como «No se pudo crear el directorio».

¿Por qué ocurre?

  • Los permisos de archivos y carpetas no son correctos.
  • El propietario del archivo no coincide con el usuario del servidor web.

Solución estándar

Desde cPanel o Syspanel (a través del administrador de archivos o SSH), ejecuta estos comandos (ajusta la ruta a tu instalación):

# Para archivos: 644
find /ruta/a/tu/wordpress -type f -exec chmod 644 {} \;

# Para carpetas: 755
find /ruta/a/tu/wordpress -type d -exec chmod 755 {} \;

# Para la carpeta wp-content y uploads (permisos de escritura)
chmod -R 775 wp-content/uploads
chmod -R 775 wp-content/plugins
chmod -R 775 wp-content/themes

[WARNING] No uses permisos 777 a menos que sepas exactamente lo que haces. Es un agujero de seguridad enorme.

6. Problemas de Subida de Archivos: «El archivo subido excede la directiva upload_max_filesize»

Intentas subir un tema o plugin grande y WordPress te lo rechaza.

Solución

  1. Desde cPanel: Busca «Selector de versión de PHP» o «MultiPHP INI Editor». Aumenta los valores de:

    • upload_max_filesize (ej. 64M)
    • post_max_size (ej. 64M)
    • max_execution_time (ej. 300)

  2. Desde Syspanel: Ve a Syspanel (puerto 2106) > Servidor > Configuración de PHP. Edita los mismos parámetros.

  3. Creando un archivo php.ini: Si no tienes acceso a esos paneles, crea un archivo llamado php.ini en la raíz de WordPress con:

    upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

  4. Modificando el .htaccess: Añade estas líneas al final:

    php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300

7. El Bucle de Redirección Infinito

El sitio carga y carga, pero nunca muestra la página. En la barra de direcciones ves algo como tudominio.com/wp-admin/wp-admin/wp-admin....

Causas

  • Configuración incorrecta de la URL de WordPress en wp-config.php o en la base de datos.
  • Un plugin de caché o redirección conflictivo.
  • Problemas con el protocolo HTTPS/SSL.

Solución

  1. Revisa las URL en wp-config.php: Añade estas líneas (ajustando las URL):

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

  2. Limpia la caché del navegador y del servidor.

  3. Desactiva plugins de caché y redirección renombrando sus carpetas.

  4. Si tienes SSL, fuerza HTTPS desde el panel de control (cPanel o Syspanel) y asegúrate de que no haya redirecciones duplicadas.

Preguntas Frecuentes (FAQ)

¿Puedo instalar WordPress manualmente sin cPanel?

Sí, puedes descargar WordPress, subirlo por FTP, crear la base de datos por línea de comandos (MySQL) y editar wp-config.php manualmente. Es más complejo pero posible.

¿Qué hago si mi hosting usa Syspanel (HestiaCP)?

Accede por el puerto 2106. La gestión de bases de datos está en «Base de datos», los archivos en «Web» > «Administrador de archivos», y la configuración de PHP en «Servidor» > «Configuración de PHP». Las soluciones aquí descritas aplican igual.

¿Cómo sé si mi servidor usa Apache o Nginx?

Pregunta a tu proveedor. Si usas Syspanel, es casi seguro que es Nginx. Si usas cPanel, suele ser Apache. En la línea de comandos, apache2 -v o nginx -v te lo dirán.

¿Es seguro modificar el archivo wp-config.php?

Sí, siempre que no borres nada esencial ni dejes líneas de depuración activas en producción. Haz siempre una copia de seguridad antes.

Resumen y Consejo Final

La mayoría de los errores WordPress Linux se solucionan con paciencia y siguiendo un orden lógico: primero verifica la base de datos, luego los permisos, después desactiva plugins y temas, y finalmente revisa los archivos de configuración.

Recuerda que cPanel y Syspanel son tus aliados: usan sus herramientas de logs y administración de archivos para diagnosticar. Y si te sientes perdido, no dudes en contactar al soporte técnico de tu hosting. A veces, un simple reinicio del servidor web o de la base de datos desde el panel resuelve todo.

[TIP] La prevención es clave. Antes de instalar WordPress, asegúrate de que tu servidor cumpla con los requisitos mínimos (PHP 7.4+, MySQL 5.6+ o MariaDB 10.1+, y suficiente memoria). Esto evitará muchos dolores de cabeza.

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel