Error 500 en WordPress con Syspanel: Cómo solucionarlo

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver juntos uno de los errores más comunes (y a veces más frustrantes) al instalar WordPress: el temido error 500. Si ves una pantalla en blanco o un mensaje como “Error interno del servidor”, no te preocupes. Te guiaré paso a paso para solucionarlo, especialmente si estás usando Syspanel (antes conocido como HestiaCP, y que siempre recordarás porque se accede por el puerto 2106). Vamos a ello.

¿Qué es el error 500 y por qué aparece?

El error 500 es un código de estado HTTP que significa “Error interno del servidor”. Es genérico, lo que quiere decir que el servidor web (Apache o Nginx) no puede procesar tu petición por algún problema interno, pero no te dice exactamente cuál. Al instalar WordPress, suele aparecer por varias razones:

Permisos de archivos incorrectos (el más común).
Archivos corruptos o faltantes de WordPress.
Conflictos con plugins o temas (incluso antes de activarlos).
Límite de memoria PHP excedido.
Errores en el archivo .htaccess.
Problemas con la versión de PHP.

No te asustes. La mayoría de estas causas tienen solución sencilla. Empecemos con lo básico.

Paso 1: Activar el modo debug de WordPress (la pista más importante)

Antes de tocar nada, lo mejor es que WordPress te diga exactamente qué está fallando. Para ello, activaremos el modo debug. Esto mostrará el error real en lugar de la pantalla en blanco.

Conéctate a tu servidor vía FTP o mediante el Administrador de archivos de Syspanel. Si usas FTP, necesitarás las credenciales que te proporcionó tu hosting. Si usas Syspanel, ve a Web > Dominio y busca el botón Administrador de archivos.
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress (normalmente en /public_html/ o /public_html/nombredetudominio/).
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, o el editor interno de Syspanel).
Busca la línea que dice: define('WP_DEBUG', false);
Cámbiala por esto:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```
- WP_DEBUG: Activa el modo debug.
- WP_DEBUG_LOG: Guarda los errores en un archivo llamado debug.log dentro de la carpeta wp-content.
- WP_DEBUG_DISPLAY: Lo dejamos en false para que los errores no se muestren en pantalla (a veces rompen el diseño), sino que se guarden en el log.
Guarda el archivo y vuelve a cargar tu web. Si el error 500 persiste, revisa la carpeta /wp-content/. Allí debería haberse creado un archivo debug.log. Ábrelo. Verás líneas como:
```
PHP Fatal error:  Allowed memory size of 41943040 bytes exhausted (tried to allocate 20480 bytes) in /ruta/wp-includes/functions.php on line 123
```
Esa línea es oro. Te dirá exactamente qué archivo o función está causando el problema. Anótala.

[TIP] Si no ves el archivo debug.log, puede que los permisos de la carpeta wp-content no permitan escribir. Lo solucionaremos en el siguiente paso.

Paso 2: Revisar y corregir permisos de archivos y carpetas

Este es el culpable número uno del error 500 WordPress en Syspanel. Los archivos y carpetas deben tener permisos específicos para que el servidor web (Apache/Nginx) y WordPress puedan trabajar juntos.

En Syspanel, cuando creas un usuario, los archivos suelen pertenecer al usuario del sistema (ej: admin) y al grupo www-data. Los permisos correctos son:

Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el grupo y otros).
Archivos: 644 (lectura y escritura para el propietario; solo lectura para el grupo y otros).
Archivo wp-config.php: 640 o 644 (nunca 777).

¿Cómo corregirlos?

Opción A: Usando el Administrador de archivos de Syspanel

Ve a Web > Dominio > Administrador de archivos.
Navega hasta la raíz de tu WordPress.
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic en Permisos (o Chmod).
Marca las casillas para:
- Propietario: Lectura, Escritura, Ejecución (para carpetas) / Lectura, Escritura (para archivos).
- Grupo: Lectura, Ejecución (carpetas) / Lectura (archivos).
- Otros: Lectura, Ejecución (carpetas) / Lectura (archivos).
Marca la opción Aplicar a subdirectorios y Aplicar a archivos.
Haz clic en Aceptar.

Opción B: Por SSH (si te sientes más avanzado)

Conéctate por SSH a tu servidor y ejecuta:

# Primero, ve a la carpeta raíz de tu dominio
cd /home/usuario/web/nombrededominio/public_html

# Cambia 'usuario' por tu nombre de usuario de Syspanel

# Permisos para carpetas
find . -type d -exec chmod 755 {} \;

# Permisos para archivos
find . -type f -exec chmod 644 {} \;

# Permiso especial para wp-config.php
chmod 640 wp-config.php

Después de esto, recarga tu web. Si el error persiste, continuamos.

Paso 3: Comprobar el límite de memoria PHP

Si en el debug.log viste un error de memoria agotada, necesitas aumentarla. WordPress es glotón, especialmente con plugins pesados.

¿Cómo hacerlo en Syspanel?

Syspanel gestiona las versiones de PHP de forma independiente para cada dominio. Para cambiar el límite de memoria:

Inicia sesión en Syspanel (recuerda, puerto 2106).
Ve a Web > Dominio y haz clic en el dominio problemático.
Busca la sección PHP o Versión de PHP. Verás un botón de Editar o un engranaje.
Allí encontrarás una opción llamada memory_limit. Cámbiala a un valor más alto, por ejemplo:
- 256M (recomendado para sitios pequeños).
- 512M (para sitios medianos con varios plugins).
- 1024M (solo si es necesario, para sitios grandes).
También puedes ajustar max_execution_time a 300 (segundos) y upload_max_filesize a 64M para evitar otros errores.
Guarda los cambios y reinicia el servicio de PHP desde la misma interfaz (suele haber un botón Reiniciar o Apply).

[WARNING] No pongas memory_limit a un valor excesivo como -1 (ilimitado) a menos que sepas lo que haces, porque podría saturar el servidor.

Paso 4: Revisar el archivo `.htaccess`

Un .htaccess corrupto o mal escrito puede generar un error 500 inmediato. WordPress genera uno automáticamente, pero a veces se daña.

Conéctate por FTP o Administrador de archivos.
Busca el archivo .htaccess en la raíz de WordPress.
Renómbralo a .htaccess_old (esto lo desactiva).
Recarga tu web. Si el error 500 desaparece, el problema era ese archivo.
Para regenerarlo, ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress (si puedes acceder) y haz clic en Guardar cambios. Si no puedes acceder, crea un nuevo .htaccess con el siguiente contenido básico:

# BEGIN WordPress
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]
# END WordPress

Paso 5: Desactivar plugins y temas manualmente (antes de instalarlos)

A veces, el error 500 aparece durante la instalación de WordPress, incluso antes de que puedas ver el escritorio. Esto puede deberse a que el instalador intenta activar un tema o plugin predeterminado que tiene un conflicto.

Solución: Desactivar todo manualmente

Conéctate por FTP o Administrador de archivos.
Ve a la carpeta /wp-content/plugins/.
Renombra la carpeta entera a plugins_desactivados (o cualquier nombre). Esto desactiva todos los plugins de golpe.
Ve a la carpeta /wp-content/themes/.
Renombra la carpeta del tema activo (por defecto suele ser twentytwentyfour o similar) a temporal. WordPress usará un tema por defecto (si existe) o fallará pero sin error 500.
Recarga tu web. Si ahora ves la pantalla de instalación o el escritorio (aunque feo), el problema era un plugin o tema.
Para reinstalar WordPress limpio, borra todo y vuelve a subir los archivos desde cero (preferiblemente usando el instalador automático de Syspanel, que evita estos problemas).

[INFO] Si estás usando el Instalador automático de WordPress que trae Syspanel (en Web > Dominio > Instalar WordPress), es muy raro que dé error 500, porque ya configura los permisos y la base de datos correctamente. Si lo hiciste manualmente, revisa los pasos anteriores.

Paso 6: Verificar la versión de PHP y extensiones

WordPress necesita PHP 7.4 o superior (recomendado 8.0+). Syspanel te permite cambiar la versión de PHP por dominio.

En Syspanel, ve a Web > Dominio.
En la sección PHP, verás la versión actual. Si es inferior a 7.4, cámbiala a una más reciente (por ejemplo, 8.1 o 8.2).
También asegúrate de que las extensiones necesarias estén activadas: mysqli, curl, mbstring, xml, zip, gd. En Syspanel, al editar la versión PHP, suele haber una lista de extensiones que puedes marcar/desmarcar.
Guarda y reinicia PHP.

Paso 7: Revisar los logs del servidor (Syspanel)

Si nada de lo anterior funciona, es hora de mirar los logs del servidor web. Syspanel guarda los errores de Apache/Nginx.

Conéctate por SSH a tu servidor.
Ejecuta los siguientes comandos para ver los últimos errores:

# Para Apache (si usas Apache)
tail -f /var/log/apache2/error.log

# Para Nginx (si usas Nginx)
tail -f /var/log/nginx/error.log

Busca líneas que contengan PHP Fatal error o 500. Te darán la pista definitiva. Por ejemplo:

[error] 1234#0: *1 FastCGI sent in stderr: "PHP message: PHP Fatal error:  Uncaught Error: Class 'WP_Error' not found in /home/usuario/web/dominio/public_html/wp-includes/class-wp-http.php:123"

Ese error concreto te indica que falta un archivo de WordPress (en este caso, class-wp-http.php). La solución sería reinstalar WordPress.

Preguntas Frecuentes (FAQ)

¿Por qué veo el error 500 justo después de instalar WordPress manualmente?

Lo más probable es que los permisos de archivos no sean los correctos. Syspanel asigna permisos estrictos por seguridad. Sigue el Paso 2 para corregirlos.

¿El error 500 puede deberse a un problema con la base de datos?

Sí, pero es menos común. Si la base de datos no se creó correctamente o los datos de conexión en wp-config.php son incorrectos, WordPress no puede conectarse y puede lanzar un error 500. Verifica que el nombre de la base de datos, el usuario y la contraseña en wp-config.php coincidan con los que creaste en Syspanel (en Base de datos > Añadir base de datos).

¿Qué hago si ni siquiera puedo acceder al escritorio de Syspanel (puerto 2106)?

Si no puedes acceder a Syspanel, el problema es más grave (servidor caído, firewall, etc.). Contacta con tu proveedor de hosting. Pero si solo es tu web la que da error 500, Syspanel debería funcionar sin problemas.

¿Debo usar el instalador automático de Syspanel o hacerlo manual?

Recomiendo siempre el instalador automático de Syspanel. Está optimizado para el panel, configura los permisos, la base de datos y la versión de PHP correctamente. Si lo haces manual, asegúrate de seguir todos los pasos de este artículo.

¿El error 500 puede aparecer después de una actualización de WordPress?

Sí. A veces una actualización falla o un plugin no es compatible. En ese caso, desactiva todos los plugins (renombrando la carpeta) y cambia al tema por defecto (Twenty Twenty-Four) para ver si se soluciona.

Resumen final

El error 500 al instalar WordPress en Syspanel (puerto 2106) es un problema común pero solucionable. La clave está en:

Activar el modo debug para obtener el mensaje de error real.
Corregir los permisos de archivos y carpetas (755/644).
Aumentar el límite de memoria PHP desde la configuración del dominio.
Revisar el .htaccess y desactivar plugins/temas manualmente.
Verificar la versión de PHP y sus extensiones.
Consultar los logs del servidor si todo lo demás falla.

No te desanimes. La mayoría de las veces, el error se soluciona en los primeros 3 pasos. Si después de todo esto sigues teniendo problemas, escríbenos en los comentarios o contacta con nuestro soporte técnico. ¡Estamos aquí para ayudarte!

[TIP FINAL] Antes de instalar WordPress, asegúrate de que tu dominio esté apuntando correctamente a los DNS de Syspanel y que el certificado SSL esté activo (puedes instalarlo gratis con Let's Encrypt desde el panel). Un error de DNS a veces se manifiesta como un error 500.

¡Buena suerte con tu instalación!