Securely Manage Remote PostgreSQL Servers with pgAdmin on Mac OS X

Updated by Phil Zona

Contribute on GitHub

View Project | View File | Edit File

pgAdmin is a free, open-source PostgreSQL database administration GUI for Microsoft Windows, Apple Mac OS X and Linux systems. It offers excellent capabilities with regard to database server information retrieval, development, testing, and ongoing maintenance. This guide will help you get up and running with pgAdmin on Mac OS X, providing secure access to remote PostgreSQL databases. It is assumed that you have already installed PostgreSQL on your Linode in accordance with our PostgreSQL installation guides.

Install pgAdmin

  1. Visit the pgAdmin download page to obtain the most recent version of the program. Save the installer to your desktop and launch it. Read the license agreement and click the “Agree” button to continue.

    pgAdmin on Mac OS X installer license agreement dialog

  2. After the program has uncompressed itself, you’ll see a pgAdmin icon in a Finder window. You may drag this to your Applications folder or your dock.

Configure SSH Tunnel

While PostgreSQL supports SSL connections, it is not advisable to instruct it to listen on public IP addresses unless absolutely necessary. For this reason, you’ll be using following command to create an SSH tunnel to your database server, replacing username with your Linux username and remote-host with your Linode’s hostname or IP address:

1
ssh -f -L 5433:127.0.0.1:5432 username@remote-host -N

Although PostgreSQL uses port 5432 for TCP connections, we’re using the local port 5433 in case you decide to install PostgreSQL locally later on.

Use pgAdmin

  1. Launch pgAdmin and you’ll be presented with a default view containing no servers. Click “File -> Add Server” as shown below.

    pgAdmin III default view on Mac OS X

  2. If you’re having problems connectiong you may need to check PostgreSQL’s configuration to ensure it accepts connections. Modify the following lines in /etc/postgresql/9.5/main/postgresql.conf if necessary:

    /etc/postgresql/9.5/main/postgresql.conf
    1
    2
    3
    listen_addresses = 'localhost'
            
    port = 5432
    

    Restart PostgreSQL to activate these changes. This command may vary among different distributions:

    1
    sudo systemctl restart postgresql
    
  3. In the “New Server Registration” dialog that appears, enter appropriate values for your server name and PostgreSQL account credentials. Be sure to specify “localhost” for the “Host” field, as you’ll be connecting via your SSH tunnel. In the username and password fields, enter the credentials you specified when setting up PostgreSQL.

    For greater security, uncheck the “Store password” box. Click “OK” to connect to your server.

    pgAdmin III new server details dialog on Mac OS X

  4. You will be presented with a full view of the databases that your user account has access to:

    pgAdmin III full database view on Mac OS X

Congratulations! You’ve securely connected to your remote PostgreSQL server with pgAdmin III.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

This guide is published under a CC BY-ND 4.0 license.