Postgresql For Mac Os


PostgreSQL JDBC for macOS. This tutorial shows how to set up a data source and connect to a PostgreSQL database using the Database Explorer app or the command line. This tutorial uses the JDBC4 PostgreSQL Driver, Version 8.4 to connect to a PostgreSQL 9.2 database. In this article, we’ll walk through the process of installing a Postgres database on a Mac OS X machine and set it up for Ruby on Rails development. Install Postgres Database with Homebrew. Homebrew is a popular package manager for OS X. To install Postgres with Homebrew, follow the steps below.


This is a tutorial for setting up PostgreSQL on MacOS. You might be wondering why there's a need for another setup guide for Postgres in the first place, since there are a few across the web. I found many tutorials and guides on how to set it up, but found most of them to be unclear and outdated, based on old PostgreSQL versions. The checklist is not comprehensive, though, as it is used for several tutorials on my website, I keep it updated with the recent versions of PostgreSQL. If you spot any flaws in this guide, a comment below would be very helpful to keep it up to date for other developers.

If you want to run PostgreSQL on Windows instead, you will find guidance over here: How to setup PostgreSQL on Windows.

PostgreSQL Installation on MacOS

I recommend Homebrew for installing and managing applications on MacOS. It is installed using the following command in the MacOS terminal:


The terminal runs through a series of installation operations, and will probably create folders in your local machine to accommodate Homebrews storage requirements. You can find more detailed instructions here. After it's installed, update the Homebrew dependencies and install PostgreSQL on the command line:

Next, check your PostgreSQL version:

The command line results will show the version you have installed on your local machine. I recommed using the latest version of libraries and software whenever possible to avoid compatibility issues with client-side applications.

How to create a physical PostgreSQL Database

Now you can initialize the physical space on your hard-disk to allocate databases. To do this, create a default postgres database on the command line in case it didn't happen automatically:


You will see the error message: 'initdb: directory '/usr/local/var/postgres' exists but is not empty' if the database was already created when you installed PostgreSQL. It means the folder where you are attempting to create a physical place for the database already has one. Either way, next you can move on to the next step.

When you connect to this physical database later, you will see an actual database which is called 'postgres' as well. The postgres database is meant to be the default database for any third-party tools that you are using in combination with PostgreSQL. These tools attempt to make the default connection to this default database, so you shouldn't delete it.

How to start/stop a PostgreSQL Database

Let's see next how you can interact with the actual database. Manually start and stop your Postgres database server with the following commands:

The terminal will confirm these operations with 'server started' and 'server stopped' feedback. You could also implement a script to start the server each time you boot up the machine, but I like to have control over when to start and stop my database server to avoid complications.

How to create the actual PostgreSQL Database

Next, let's go through the steps of setting up a database that can be used for one of your applications. Make sure the Postgre server is started first, then type these commands in the command line to create and remove a database:

You can also connect to databases to execute SQL statements. Either use the psql command, or specify a database such as the default postgres database to connect:

The command leads you to the psql shell, which you can exit by typing CTRL + d. In the psql shell, you can create and drop databases as well:

To list all your databases, you can type list. Your will see any new databases listed, as well as two default databases that come with postgreSQL called template0 and template1. The templates should remain in your database list even if you aren't using them, as they may be useful later.

  • list - List all of your actual databases.
  • c mydatabasename - Connect to another database.
  • d - List the relations of your currently connected database.
  • d mytablename - Shows information for a specific table.
Continue Reading: PostgreSQL with Sequelize in Express Tutorial

PostgreSQL JDBC for macOS

This tutorial shows how to set up a data source and connect to a PostgreSQL database using the Database Explorer app or the command line. This tutorial uses the JDBC4 PostgreSQL Driver, Version 8.4 to connect to a PostgreSQL 9.2 database.

Step 1. Verify the driver installation.

If the JDBC driver for PostgreSQL is not installed on your computer, find the link on the Driver Installation page to install the driver. Follow the instructions to download and install this driver on your computer.

Step 2. Set up the data source.

You set up a data source using the Database Explorer app or the command line.

Set Up Data Source Using Database Explorer App

  1. Open the Database Explorer app by clicking the Apps tab on the MATLAB® Toolstrip. Then, on the right of the Apps section, click the Show more arrow to open the apps gallery. Under Database Connectivity and Reporting, click Database Explorer. Alternatively, enter databaseExplorer at the command line.

  2. In the Data Source section, select Configure Data Source > Configure JDBC data source.

    The JDBC Data Source Configuration dialog box opens.

  3. In the Name box, enter a name for your data source. (This example uses a data source named PostgreSQL.) You use this name to establish a connection to your database.

  4. From the Vendor list, select PostgreSQL.

  5. In the Driver Location box, enter the full path to the JDBC driver file.

  6. In the Database box, enter the name of your database. In the Server box, enter the name of your database server. Consult your database administrator for the name of your database server. In the Port Number box, enter the port number.

  7. Under Connection Options, in the Name column, enter the name of an additional driver-specific option. Then, in the Value column, enter the value of the driver-specific option. Click the plus sign to specify additional driver-specific options.

  8. Click . The Test Connection dialog box opens. Enter the user name and password for your database, or leave these boxes blank if your database does not require them. Click .

    If your connection succeeds, the Database Explorer dialog box displays a message indicating the connection is successful. Otherwise, it displays an error message.

  9. Click . The JDBC Data Source Configuration dialog box displays a message indicating the data source is saved successfully. Close this dialog box.

Set Up Data Source Using Command Line

  1. Create a JDBC data source for a PostgreSQL database.

  2. Set the JDBC connection options. For example, this code assumes that you are connecting to a JDBC data source named PostgreSQL, full path of the JDBC driver file /home/user/DB_Drivers/postgresql-8.4-702.jdbc4.jar, database name toystore_doc, database server dbtb00, and port number 5432.

  3. Test the database connection by specifying the user name username and password pwd, or leave these arguments blank if your database does not require them.

  4. Save the JDBC data source.

After you complete the data source setup, connect to the PostgreSQL database using the Database Explorer app or the JDBC driver and command line.

Step 3. Connect using the Database Explorer app or the command line.

Connect to PostgreSQL Using Database Explorer App

  1. On the Database Explorer tab, in the Connections section, click and select the data source for the connection.

  2. In the connection dialog box, enter a user name and password, or leave these boxes blank if your database does not require them. Click .

    The Catalog and Schema dialog box opens.

  3. Select the catalog and schema from the Catalog and Schema lists. Click .

    The app connects to the database and displays its tables in the Data Browser pane. A data source tab appears to the right of the pane. The title of the data source tab is the data source name that you defined during the setup. The data source tab contains empty SQL Query and Data Preview panes.

  4. Select tables in the Data Browser pane to query the database.

  5. Close the data source tab to close the SQL query. In the Connections section, close the database connection by clicking .


    If multiple connections are open, close the database connection of your choice by selecting the corresponding data source from the list.

Mac Os Install Postgresql

Connect to PostgreSQL Using JDBC Driver and Command Line

  1. Connect to a PostgreSQL database using the configured JDBC data source, user name username, and password pwd.

  2. Close the database connection.

See Also

Postgresql For Mac Os High Sierra



Postgresql For Mac Os Versions

  • closeconfigureJDBCDataSourcedatabasesaveAsJDBCDataSourcesetConnectionOptionstestConnection

Related Topics