Conectar base de datos PostgreSQL en Plesk | Tutorial fácil

Conectar tu sitio web a una base de datos PostgreSQL es un paso fundamental para que aplicaciones dinámicas como WordPress, Laravel, Django o cualquier sistema personalizado puedan almacenar y recuperar información. Si tu hosting utiliza Plesk, el proceso es bastante sencillo, aunque requiere seguir algunos pasos clave. Esta guía está diseñada para que, incluso si no tienes experiencia técnica, puedas realizar la conexión sin problemas.

¿Qué necesitas antes de empezar?

Antes de lanzarte a la configuración, es importante que tengas a mano cierta información. Sin ella, el proceso puede volverse confuso. Asegúrate de tener lo siguiente:

Acceso a Plesk: Necesitas las credenciales de administrador o de un usuario con permisos para gestionar bases de datos.
Nombre de la base de datos PostgreSQL: Si aún no la has creado, la crearemos en los pasos siguientes.
Usuario y contraseña de la base de datos: Los definirás durante el proceso.
Aplicación o script a conectar: Puede ser un CMS, un framework o tu propio código. Necesitarás saber dónde se configuran los datos de conexión (normalmente en un archivo como .env, wp-config.php o settings.py).

[INFO] PostgreSQL es un sistema de gestión de bases de datos relacional de código abierto, muy potente y robusto. Plesk lo soporta nativamente, lo que facilita su administración.

Creación de la base de datos PostgreSQL en Plesk

El primer paso es crear la base de datos y el usuario que la gestionará. Plesk simplifica este proceso en una sola interfaz.

Accede al panel de bases de datos

Inicia sesión en tu panel de Plesk.
En el menú lateral, busca y haz clic en la sección Bases de datos. Normalmente tiene un icono de un cilindro de base de datos.
Verás un listado de tus bases de datos existentes (si las hay). Para crear una nueva, haz clic en el botón Añadir base de datos.

Configura los detalles de la nueva base de datos

Se abrirá un formulario. Rellena los campos con cuidado:

Nombre de la base de datos: Elige un nombre descriptivo, como miapp_produccion o blog_datos. Evita espacios y caracteres especiales; usa guiones bajos (_).
Tipo de base de datos: Selecciona PostgreSQL en el menú desplegable. Es crucial no equivocarte aquí.
Nombre de usuario de la base de datos: Crea un nombre de usuario, por ejemplo, miapp_user.
Contraseña: Introduce una contraseña segura. Puedes usar el generador de contraseñas de Plesk (icono de llave inglesa) para crear una robusta automáticamente. Guarda esta contraseña en un lugar seguro, la necesitarás más adelante.
Resto de opciones: Generalmente, puedes dejar las opciones por defecto (como la codificación UTF-8) a menos que tu aplicación requiera algo específico.

Haz clic en Aceptar o Crear. Plesk creará la base de datos y el usuario, y le asignará los permisos necesarios automáticamente.

[TIP] Si tu aplicación requiere una versión específica de PostgreSQL, verifica que esté disponible en tu plan de hosting. Plesk suele gestionar varias versiones.

Obteniendo los datos de conexión

Una vez creada la base de datos, necesitas los parámetros exactos para conectarte desde tu aplicación.

Localiza la información en Plesk

Vuelve a la sección Bases de datos en Plesk.
Busca la base de datos que acabas de crear en la lista.
Haz clic en el nombre de la base de datos para abrir sus detalles.

Verás una pantalla con información similar a esta:

Nombre de la base de datos: (El que elegiste)
Nombre de usuario: (El que elegiste)
Servidor (host): Aquí está la clave. Normalmente verás algo como localhost. En entornos de hosting compartido o en servidores remotos, podría ser una dirección IP o un nombre de dominio como localhost o 127.0.0.1. Anota este valor exactamente como aparece.
Puerto: PostgreSQL usa por defecto el puerto 5432. Asegúrate de que esté abierto en tu servidor (Plesk lo configura así por defecto).
Contraseña: No se muestra por seguridad, pero es la que definiste al crear la base de datos.

Con estos cuatro datos (host, puerto, nombre de BD, usuario y contraseña) ya puedes configurar tu aplicación.

Configurando tu aplicación para conectar con PostgreSQL

Ahora viene la parte práctica: indicarle a tu sitio web o aplicación cómo llegar a la base de datos. El método varía según el software que uses, pero el principio es el mismo.

Conexión con WordPress (usando un plugin o código)

WordPress usa MySQL por defecto, pero puede funcionar con PostgreSQL mediante un plugin. El más conocido es PostgreSQL for WordPress (PG4WP).

Instala y activa el plugin desde el repositorio de WordPress.
El plugin normalmente detecta la configuración automáticamente si tu servidor tiene PostgreSQL. Si no, deberás editar el archivo wp-config.php.
Busca las líneas que definen DB_NAME, DB_USER, DB_PASSWORD, DB_HOST. Cámbialas por los datos de tu base de datos PostgreSQL.

El bloque en wp-config.php se vería así:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost'); // O la IP/host que te dio Plesk

[WARNING] Asegúrate de que el plugin PG4WP sea compatible con tu versión de WordPress y PostgreSQL. Algunos plugins pueden no estar actualizados.

Conexión con Laravel (archivo .env)

Laravel es un framework PHP que utiliza un archivo .env para la configuración. Es muy común en aplicaciones modernas.

Accede a la raíz de tu proyecto Laravel.
Abre el archivo .env con un editor de texto.
Busca las líneas que comienzan con DB_. Deberías tener algo como:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

Cámbialas por los datos de PostgreSQL. Quedaría así:

DB_CONNECTION=pgsql
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=nombre_de_tu_bd
DB_USERNAME=tu_usuario
DB_PASSWORD=tu_contraseña

Guarda el archivo. Laravel leerá estos parámetros automáticamente.

Conexión con Django (settings.py)

Django, el popular framework Python, usa un archivo settings.py para la configuración de la base de datos.

Localiza el archivo settings.py dentro de tu proyecto Django.
Busca la variable DATABASES. Verás un diccionario con la configuración.
Modifícala para que use PostgreSQL. Debe verse así:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'nombre_de_tu_bd',
        'USER': 'tu_usuario',
        'PASSWORD': 'tu_contraseña',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

Guarda el archivo y reinicia tu aplicación Django para que los cambios surtan efecto.

[INFO] Si tu aplicación no es ninguna de las anteriores, busca en su documentación la sección "Configuración de base de datos" o "Database setup". Todos los sistemas siguen un patrón similar: indicar el tipo de BD, host, puerto, nombre, usuario y contraseña.

Solución de problemas comunes (FAQ)

A veces, aunque sigas los pasos al pie de la letra, pueden surgir problemas. Aquí tienes los más frecuentes y cómo resolverlos.

Error: "Could not connect to server: Connection refused"

Causa: El servidor de PostgreSQL no está aceptando conexiones o el puerto está bloqueado.

Solución:

Verifica que PostgreSQL esté instalado y en ejecución en tu servidor. En Plesk, ve a Herramientas y Configuración > Servicios del sistema y asegúrate de que el servicio postgresql esté activo.
Comprueba que el puerto 5432 no esté bloqueado por un firewall. Si usas un firewall en el servidor (como iptables o firewalld), permite el tráfico entrante al puerto 5432 desde tu IP o desde localhost.
Si tu aplicación está en un servidor diferente, asegúrate de que PostgreSQL esté configurado para escuchar en todas las interfaces (no solo localhost). Esto se configura en el archivo postgresql.conf.

Error: "FATAL: password authentication failed for user"

Causa: La contraseña que estás usando no coincide con la que tiene el usuario en PostgreSQL.

Solución:

Vuelve a Plesk, a la sección Bases de datos.
Haz clic en el nombre de la base de datos.
Busca la opción Cambiar contraseña (suele estar cerca del nombre de usuario). Cambia la contraseña por una nueva y asegúrate de actualizarla también en tu aplicación.
Si el problema persiste, elimina el usuario y vuelve a crearlo desde Plesk.

Error: "database does not exist"

Causa: El nombre de la base de datos en tu aplicación no coincide exactamente con el que creaste en Plesk.

Solución:

Revisa el nombre de la base de datos en Plesk (puede tener un prefijo como usuario_nombrebd).
Copia el nombre exacto, incluyendo mayúsculas, minúsculas y guiones bajos.
Pega ese nombre en la configuración de tu aplicación.

Error: "could not translate host name"

Causa: El valor del host (servidor) que pusiste en la aplicación no es correcto.

Solución:

En Plesk, en los detalles de la base de datos, busca el campo Servidor (host). Usa ese valor exacto.
Si es localhost, pruébalo. Si es una IP como 127.0.0.1, úsala. En servidores remotos, suele ser el nombre del servidor o una IP pública.

¿Cómo conectarme desde mi computadora local (remotamente)?

Plesk suele restringir las conexiones remotas a la base de datos por seguridad. Sin embargo, puedes habilitarlo:

En Plesk, ve a Bases de datos > selecciona tu base de datos.
Busca la opción Acceso remoto o Permitir acceso remoto.
Añade la dirección IP de tu computadora (o un rango) desde la que te conectarás.
También necesitarás que el puerto 5432 esté abierto en el firewall del servidor para tu IP.
Usa herramientas como pgAdmin, DBeaver o la línea de comandos (psql -h tu-servidor -p 5432 -U tu_usuario -d tu_bd) para conectarte.

[WARNING] Habilitar el acceso remoto a la base de datos aumenta la superficie de ataque. Limítalo solo a las IPs que realmente lo necesiten y usa contraseñas seguras.

Consejos finales para una conexión exitosa

Usa contraseñas seguras: No uses 123456 o password. Genera contraseñas largas con letras, números y símbolos.
Mantén un backup: Antes de hacer cambios en la configuración de la base de datos, realiza una copia de seguridad. En Plesk puedes hacerlo desde la sección Bases de datos > Copias de seguridad.
Prueba la conexión: Después de configurar tu aplicación, intenta acceder a tu sitio web. Si ves errores, revisa los logs de tu aplicación (por ejemplo, en Laravel son storage/logs/laravel.log).
Documenta tus configuraciones: Guarda en un lugar seguro (como un gestor de contraseñas) los datos de conexión: host, puerto, usuario, contraseña y nombre de BD.
Si usas Syspanel: Recuerda que si en algún momento trabajas con Syspanel (anteriormente HestiaCP), el acceso a su panel de administración se realiza a través del puerto 2106. La gestión de bases de datos PostgreSQL en Syspanel es similar a Plesk, pero con una interfaz diferente.

Conectar PostgreSQL en Plesk es un proceso que, una vez entendido, se vuelve rutinario. Sigue estos pasos, presta atención a los detalles y no dudes en consultar la documentación de tu aplicación específica. ¡Tu sitio web estará funcionando con una base de datos robusta y confiable en poco tiempo!