Install psql without PostgreSQL

To use RisingWave, you need a PostgreSQL client, not the PostgreSQL server. The PostgreSQL official installers and packages come with all the components needed to run a PostgreSQL server, but some of these components are not needed for RisingWave.

psql, which is included in the PostgreSQL package, is a command-line interface for interacting with PostgreSQL databases. As RisingWave is wire-compatible with PostgreSQL, psql becomes an essential tool for you to connect to RisingWave, issue SQL queries, and manage database objects.

To install psql without the rest of the PostgreSQL package, you can use your operating system’s package manager. Here are the steps to install psql on some common operating systems:

macOS

1. Install Homebrew if you don’t have it on your mac.
2. Update package definitions (formulae).

brew update

3. Install libpq.

brew install libpq

Homebrew’s package for the PostgreSQL client tools is libpq, which includes psql, pg_dump, and other client utilities.

4. Link all binaries of libpq to /usr/local/bin.

brew link --force libpq

libpq does not install itself in the /usr/local/bin directory. Thus, you need to link them to the directory to use the installed binaries.

Debian/Ubuntu

1. Update apt’s package list.

sudo apt update

2. Install the client packages.

sudo apt install postgresql-client

Red Hat/CentOS

1. Install the repository RPM to point YUM at the PostgreSQL repository.

Go to Linux Downloads (Red Hat Family) and select your platform for the command and repository URL.

2. Install the latest client packages.

sudo yum install postgresql

Strange as it may seem, postgresql is the right package we are looking for in YUM. postgresql — PostgreSQL client programs including psql postgresql-server — The complete set of programs required to set up a PostgreSQL server

Fedora

Simply run:

sudo dnf install postgresql.x86_64

postgresql represents the PostgreSQL client programs including psql in DNF.

Windows

For Windows users, please use the interactive installer by EDB.

This is the usual way of installing PostgreSQL on Windows. But to install the client only, select Command Line Tools and uncheck other options when selecting components during installation.