PostgreSQL

PostgreSQL is an advanced open-source relational database management system widely used in applications. With Kinsta’s Database Hosting, you can easily add a new PostgreSQL database from the dashboard, click Databases > Add database and select the required options. 

If you have an existing database locally or with another hosting provider, you can import the PostgreSQL database into Kinsta’s Database Hosting using a third-party database tool or the Command Line Interface (CLI). Note: To import a database, you must create a new database in MyKinsta first.

Import a PostgreSQL Database Using a Database Tool

There are many database tools you can use to connect and manage your database; we have step-by-step instructions for TablePlus, as this tool allows you to manage all the database types you can host on Kinsta.

You can use any database client or tool that supports your database type. While some specifics, like navigation and field names, may vary between database tools, the fundamental concepts are the same.

Import a PostgreSQL Database Using the Command Line Interface (CLI)

You can use the command line interface (CLI) to import your PostgreSQL database into Kinsta. The installation of the database server and commands vary for each database type. This article is specific to PostgreSQL. For other database types, see:

• MySQL
• MariaDB
• Redis
• Valkey

Install PostgreSQL

If you do not yet have PostgreSQL installed on your local machine, you’ll need to install it to connect to your database. Depending on your operating system, you can install PostgreSQL in the following ways.

Windows

Download and install the GUI installer or binaries for the Interactive installer by EDB.

MacOS

With Homebrew, replace XX in the following command with the version of PostgreSQL you want to install:

brew install postgresql@XX

Debian-based Linux (Debian, Ubuntu, Mint, etc.)

Use the PostgreSQL APT repository and install the postgresql-client.

RedHat-based Linux (RedHat Fedora, CentOS, etc.)

Use the PostgreSQL Yum repository and install the postgresql-client.

Kinsta Database Credentials

You can find your database credentials under External connections on the database Overview page.

Import a PostgreSQL Database

Use the following command to export the database, replacing EXTERNAL_HOSTNAME, USERNAME, PORT, and DATABASE_NAME with the information from your database’s External connections. Replace export.sql with the path and name of the database you want to import:

psql -h EXTERNAL_HOSTNAME -U USERNAME -p PORT -d DATABASE_NAME < export.sql

When prompted, enter the database password.

No output will be produced unless there are errors, which will be printed to the command line. To verify a successful import, you can use dt or a similar command to review the data in your database.

Export a PostgreSQL Database

Use the following command to export the database, replacing EXTERNAL_HOSTNAME, USERNAME, PORT, and DATABASE_NAME with the information from your database’s External connections. Replace export.sql with the path and file name of the database you want to export:

pg_dump -h EXTERNAL_HOSTNAME -U USERNAME -p PORT -d DATABASE_NAME > export.sql

When prompted, enter the database password.

Once the export is complete, your database file (e.g. export.sql) will be available at the path you specified in the pg_dump command. You can open a .sql file with a plain text editor (e.g. TextEdit, Notepad++, Sublime Text, etc.) or a database tool like TablePlus to review the exported data.