Connect PostgreSQL

Connection setup for PostgreSQL as a source or target: local server, Amazon Aurora PostgreSQL, Heroku Postgres, and Google Cloud SQL.

For the generic source-and-destination workflow, see Source and destination connections. This page covers PostgreSQL-specific setup.

Local PostgreSQL server

To accept connections from DBConvert, edit pg_hba.conf on the PostgreSQL server and allow the IP of the machine where DBConvert runs.

Add a line of the form:

TYPEDATABASEUSERCIDR-ADDRESSMETHOD
hostallall127.0.0.1/32trust
hostallall192.168.1.0/24trust

Use md5 instead of trust if a password should be required. Reload PostgreSQL after editing the file.

pgAdmin server settings

Opening pg_hba.conf from pgAdmin

Backend access config editor

Amazon Aurora PostgreSQL

Aurora PostgreSQL connects exactly like a regular PostgreSQL endpoint. Get the endpoint and port from the AWS console.

  1. Log in to the AWS console and open RDS → Databases.
  2. Select your Aurora PostgreSQL cluster.

    Aurora PostgreSQL cluster in AWS console

  3. Copy the Endpoint and Port from the connection details.

    Aurora PostgreSQL connection details

  4. In DBConvert, paste the endpoint into Hostname, port into Port, enter the DB user and password, and click Test connection.

    Aurora PostgreSQL connection in DBConvert

  5. Click Refresh next to Database, pick the database, then pick the schema.

For non-Aurora RDS endpoints, see Amazon RDS configuration.

Heroku Postgres

Heroku exposes a host, username, password, and database name for every Heroku Postgres add-on.

  1. Open the Heroku Postgres dashboard for your app and copy Host, Database, User, and Password.
  2. In DBConvert, paste those into the corresponding fields.

    Heroku Postgres credentials in DBConvert

    Heroku Postgres credentials page

  3. Click Test connection and then Next.

Google Cloud SQL for PostgreSQL

Cloud SQL exposes a PostgreSQL endpoint behind an authorized-network rule.

1. Create the instance

In the Cloud Console, open SQL and click Create instance. Pick PostgreSQL.

Cloud SQL: create instance

Cloud SQL: choose PostgreSQL

After the instance starts, note its public IP from the Overview page - you will use it as the hostname.

Cloud SQL instance overview

2. Create a database

On the Databases page click Create database and enter a name.

Cloud SQL: create a database

3. Enable remote access

Open Connections for the instance, enable Public IP, then click + Add network and add the IP of the machine running DBConvert. Save.

Cloud SQL authorized networks

On the Users page, create a user for DBConvert and remember the password.

Cloud SQL: create user

4. Connect from DBConvert

Paste the instance's public IP into Hostname, enter the user and password, and click Test connection. Then click Refresh next to Database and pick the database you created.

Cloud SQL connection in DBConvert

Cloud SQL database list in DBConvert

Cloud SQL connected

Other managed PostgreSQL services

Most managed PostgreSQL platforms - Supabase, Neon, DigitalOcean, CockroachDB, Azure Database for PostgreSQL, and others - expose a standard PostgreSQL endpoint. There is no special connector: connect them like any PostgreSQL server using the host, port, database, user, and password from the provider's dashboard, and enable SSL if the service requires it.