Errores al instalar WordPress en Plesk: cómo solucionarlos

¿Te ha pasado? Estás emocionado por montar tu primer sitio web, entras a Plesk, haces clic en "Instalar WordPress" y de repente aparece un mensaje de error críptico que no entiendes. Tranquilo, es más común de lo que crees. En este artículo vamos a desglosar los errores más frecuentes durante la instalación de WordPress en Plesk y, lo más importante, te daremos soluciones paso a paso para que puedas tener tu web funcionando en minutos.

Plesk es uno de los paneles de control de hosting más potentes y amigables que existen. Sin embargo, como cualquier herramienta, a veces surgen pequeños contratiempos. La buena noticia es que la mayoría de estos errores tienen soluciones muy sencillas que no requieren ser un experto en servidores. Vamos a ello.

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

Este es, sin duda, el error más común y también el que más frustra a los principiantes. Aparece justo después de instalar WordPress o al intentar acceder al sitio. La causa suele ser que los datos de la base de datos no coinciden con los que WordPress espera.

¿Por qué ocurre?

Credenciales incorrectas: El nombre de la base de datos, el usuario o la contraseña que pusiste en el archivo wp-config.php no son los correctos.
Base de datos no creada: A veces, el instalador automático de Plesk falla y no crea la base de datos.
Permisos de usuario: El usuario de la base de datos no tiene permisos para acceder a ella.

Solución paso a paso

Verifica las credenciales en Plesk: Ve a la sección "Bases de datos" dentro de tu suscripción. Ahí verás el nombre exacto de la base de datos y el usuario asociado. Anótalos.
Revisa el archivo wp-config.php: Conéctate por FTP o usa el administrador de archivos de Plesk. Busca la carpeta de tu sitio y abre el archivo wp-config.php. Busca estas líneas:
```
define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
```
Asegúrate de que los valores coincidan exactamente con lo que ves en Plesk. Un error común es copiar un espacio extra o una mayúscula mal puesta.
Prueba la conexión manualmente: En Plesk, usa la herramienta "phpMyAdmin" para acceder a la base de datos. Si puedes entrar, la base de datos existe y las credenciales son correctas. Si no, significa que hay un problema con la base de datos misma.
Crea una nueva base de datos desde cero: Si todo falla, borra la base de datos problemática desde Plesk y crea una nueva. Luego, vuelve a editar el wp-config.php con los nuevos datos.

[WARNING] No edites el archivo wp-config.php con un editor de texto como Bloc de notas si lo descargas por FTP. Usa editores de código como Notepad++ o VS Code para evitar problemas de formato.

Error 2: "Error de conexión FTP" o "Fallo en la instalación automática"

Cuando usas el instalador automático de WordPress dentro de Plesk (el famoso botón "Instalar WordPress"), a veces el proceso se queda a mitad de camino y muestra un error relacionado con FTP.

¿Por qué ocurre?

Falta de permisos de escritura: El servidor web (Apache o Nginx) no tiene permisos para escribir en la carpeta donde se instalará WordPress.
Configuración de FTP incorrecta: El instalador intenta usar un método de conexión FTP que no está bien configurado.
Memoria PHP insuficiente: El proceso de instalación requiere más memoria de la que tiene asignada PHP.

Solución paso a paso

Asigna permisos correctos a la carpeta: En Plesk, ve a "Administrador de archivos". Navega hasta la carpeta httpdocs (o la carpeta raíz de tu dominio). Selecciona la carpeta y haz clic en "Permisos". Asegúrate de que el usuario del sistema (generalmente se llama psacln o el nombre de tu suscripción) tenga permisos de lectura y escritura (755 o 775). Si no sabes qué poner, selecciona "Permisos heredados" o pon 755.
Aumenta la memoria PHP: En Plesk, ve a "Configuración de PHP" (dentro de tu dominio). Busca el valor memory_limit y cámbialo a al menos 256M (o más, como 512M). También puedes aumentar max_execution_time a 300 segundos para darle más tiempo al instalador.
Usa el método de instalación manual: Si el instalador automático sigue fallando, no te preocupes. Descarga WordPress desde wordpress.org, súbelo por FTP a la carpeta httpdocs y luego ejecuta la instalación manual desde tu navegador (ej: tudominio.com/wp-admin/install.php). Este método es casi infalible.

[TIP] Si tu panel de control es Syspanel (antes conocido como HestiaCP), recuerda que el acceso es a través del puerto 2106. Allí, el proceso para instalar WordPress es similar, pero la carpeta raíz suele llamarse public_html.

Error 3: "Página en blanco" o "White Screen of Death" (WSOD)

Después de instalar WordPress, intentas acceder a tu sitio y solo ves una pantalla en blanco. Sin mensajes, sin errores, solo nada. Esto es frustrante, pero tiene solución.

¿Por qué ocurre?

Problema con un plugin o tema: A veces, el instalador incluye plugins o temas predeterminados que no son compatibles con tu servidor.
Límite de memoria PHP excedido: WordPress necesita más memoria de la que tiene asignada.
Error de PHP: Un error de sintaxis en un archivo (como el functions.php del tema) puede causar esto.

Solución paso a paso

Activa el modo de depuración de WordPress: Conéctate por FTP y edita el archivo wp-config.php. Busca la línea que dice define('WP_DEBUG', false); y cámbiala a:
```
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
```
Guarda el archivo y recarga la página. Ahora deberías ver un mensaje de error específico en lugar de la pantalla en blanco. Anota ese mensaje.
Desactiva todos los plugins: Si no ves ningún error, el problema podría ser un plugin. Conéctate por FTP, ve a la carpeta wp-content/plugins y renombra la carpeta de un plugin (por ejemplo, añadiendo _old al final). Haz esto con todos los plugins. Si el sitio se recupera, ve activándolos uno por uno para identificar al culpable.
Cambia al tema por defecto: Si los plugins no son el problema, el tema podría serlo. En la carpeta wp-content/themes, renombra la carpeta de tu tema activo (por ejemplo, mi-tema a mi-tema_old). WordPress automáticamente usará el tema por defecto (Twenty Twenty-Four o similar). Si el sitio funciona, el problema está en tu tema.
Aumenta la memoria PHP nuevamente: Como en el error anterior, ve a la configuración de PHP en Plesk y sube el memory_limit a 256M o 512M.

[INFO] La pantalla en blanco es un síntoma, no la causa. Siempre activa el modo de depuración primero para obtener pistas. Si no puedes acceder al archivo wp-config.php por FTP, usa el administrador de archivos de Plesk.

Error 4: "Error 404" o "Página no encontrada" después de la instalación

Instalaste WordPress, todo parecía bien, pero al hacer clic en cualquier enlace (como "Acerca de" o "Contacto") te aparece un error 404. El problema suele ser la estructura de enlaces permanentes.

¿Por qué ocurre?

Módulo mod_rewrite desactivado: WordPress necesita que Apache tenga activado el módulo mod_rewrite para que los enlaces bonitos funcionen.
Archivo .htaccess incorrecto: El archivo .htaccess no se generó correctamente o tiene permisos incorrectos.
Servidor Nginx sin configuración adicional: Si tu servidor usa Nginx (algo común en Plesk), necesitas una configuración especial para los enlaces permanentes.

Solución paso a paso

Verifica que mod_rewrite esté activo: En Plesk, ve a "Configuración de Apache y Nginx" (dentro de tu dominio). Busca la opción "Habilitar mod_rewrite" o similar y asegúrate de que esté marcada. Si no ves esta opción, contacta a tu proveedor de hosting.
Regenera el archivo .htaccess: Conéctate por FTP y busca el archivo .htaccess en la raíz de tu sitio (carpeta httpdocs). Si no existe, créalo. Si existe, renómbralo a .htaccess_old para que WordPress genere uno nuevo. Luego, ve a Ajustes > Enlaces permanentes en el panel de WordPress y haz clic en "Guardar cambios" sin modificar nada. Esto forzará a WordPress a crear un nuevo .htaccess.
Para servidores Nginx: Si tu Plesk usa Nginx como servidor web principal (lo sabrás porque en la configuración del dominio ves opciones de Nginx), necesitas añadir reglas específicas. En Plesk, ve a "Configuración de Apache y Nginx" y en el campo "Directivas adicionales de Nginx" pega lo siguiente:
```
location / {
    try_files $uri $uri/ /index.php?$args;
}
```
Guarda los cambios y recarga la configuración.

[TIP] Si después de estos pasos el error 404 persiste, verifica que la carpeta httpdocs tenga un índice (como index.php). A veces, el instalador coloca los archivos en una subcarpeta, como httpdocs/wordpress. En ese caso, tu dominio apunta a la carpeta incorrecta. Puedes solucionarlo moviendo los archivos de la subcarpeta a la raíz.

Error 5: "El enlace que has seguido ha caducado" al subir archivos grandes

Estás subiendo un tema o un plugin desde el panel de WordPress y, cuando está casi terminando, aparece este molesto mensaje. Es un problema de límites de PHP.

¿Por qué ocurre?

Límite de subida de archivos pequeño: PHP tiene configurado un tamaño máximo de archivo (generalmente 2MB o 8MB) que es insuficiente para temas o plugins pesados.
Tiempo de ejecución insuficiente: El proceso de subida tarda más de lo permitido.

Solución paso a paso

Aumenta los límites de PHP en Plesk: Ve a "Configuración de PHP" dentro de tu dominio. Cambia estos valores:
- upload_max_filesize a 64M o 128M
- post_max_size a 64M o 128M
- max_execution_time a 300
- max_input_time a 300
  Guarda los cambios.
Verifica el límite en WordPress: Después de cambiar los valores en Plesk, ve a Herramientas > Salud del sitio en tu panel de WordPress. Revisa la sección "Rendimiento del servidor" para confirmar que los nuevos límites se están aplicando. Si no es así, es posible que necesites reiniciar el servicio de PHP desde Plesk (en "Herramientas y ajustes" > "Administrador de servicios").
Sube archivos por FTP como alternativa: Si los cambios no funcionan, una solución rápida es subir el tema o plugin manualmente por FTP. Descomprime el archivo en tu computadora, conéctate por FTP, ve a wp-content/themes (para temas) o wp-content/plugins (para plugins) y arrastra la carpeta. Luego, actívalo desde el panel de WordPress.

[WARNING] No subas archivos ZIP por FTP. WordPress no los reconocerá. Siempre descomprime primero y sube la carpeta.

Preguntas Frecuentes (FAQ)

¿Por qué mi instalación de WordPress en Plesk se queda cargando para siempre?

Esto suele deberse a un límite de memoria PHP muy bajo o a un conflicto con un plugin preinstalado. Primero, aumenta el memory_limit a 256M en la configuración de PHP de Plesk. Si sigue igual, desactiva todos los plugins manualmente por FTP (renombrando la carpeta plugins a plugins_old). Luego, intenta acceder de nuevo. Si funciona, el problema es un plugin.

¿Puedo instalar WordPress en una subcarpeta (ej: tudominio.com/blog)?

Sí, totalmente. Durante la instalación manual, solo coloca los archivos de WordPress dentro de una subcarpeta de httpdocs (por ejemplo, httpdocs/blog). Si usas el instalador automático de Plesk, te preguntará dónde instalarlo. Simplemente selecciona la opción "Subdirectorio" y escribe "blog". Luego, configura los enlaces permanentes como se explicó antes.

¿Qué hago si no encuentro la opción "Instalar WordPress" en Plesk?

Algunos planes de hosting no incluyen el instalador automático. En ese caso, la instalación manual es la mejor opción. Descarga WordPress desde wordpress.org, súbelo por FTP a la carpeta httpdocs, crea una base de datos desde Plesk (sección "Bases de datos"), y luego visita tudominio.com/wp-admin/install.php para seguir el asistente. Es más sencillo de lo que parece.

Mi panel es Syspanel (HestiaCP), ¿cómo instalo WordPress?

Syspanel es otro panel de control potente. Accede a través del puerto 2106 (ej: tudominio.com:2106). Allí, ve a "Web" > "Dominios" y selecciona tu dominio. Busca la opción "Instalar WordPress" o "Quick Installer". Si no está disponible, sigue el proceso manual: crea una base de datos, sube los archivos a public_html y ejecuta la instalación desde el navegador.

Después de instalar WordPress, veo "Error 500 Internal Server Error". ¿Qué hago?

El error 500 es genérico, pero suele deberse a un archivo .htaccess corrupto o a un plugin incompatible. Primero, renombra el archivo .htaccess a .htaccess_old para ver si se soluciona. Si no, activa el modo de depuración de WordPress (como explicamos en el error 3) para obtener más detalles. También verifica que los permisos de las carpetas sean 755 y los archivos 644.

Consejos finales para evitar problemas futuros

La instalación de WordPress en Plesk es un proceso robusto, pero como has visto, pueden surgir pequeños obstáculos. Para minimizarlos, te recomiendo:

Mantén Plesk actualizado: Las versiones nuevas corrigen errores y mejoran la compatibilidad con WordPress.
Haz copias de seguridad antes de instalar: Plesk te permite hacer backups rápidos desde "Herramientas y ajustes" > "Administrador de backups". Úsalos.
Elige un buen proveedor de hosting: Un servidor bien configurado reduce drásticamente estos errores. Si tu proveedor usa Syspanel (HestiaCP), recuerda que el acceso es por el puerto 2106.
Documenta tus pasos: Si tienes que hacer cambios en la configuración, anótalos. Te ayudará si algo sale mal después.

Recuerda, la mayoría de estos errores son temporales y tienen solución. No te desanimes si a la primera no funciona. Con un poco de paciencia y siguiendo estos pasos, tu sitio de WordPress estará online en un abrir y cerrar de ojos. ¡Ánimo y a crear contenido!