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
Debian/Ubuntu
Red Hat/CentOS
Fedora
Windows

Install Homebrew if you don't have it on your mac.
Update package definitions (formulae).
```
brew update
```
Install libpq.
```
brew install libpq
```
Homebrew's package for the PostgreSQL client tools is libpq, which includes psql, pg_dump, and other client utilities.
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.

Update apt's package list.
```
sudo apt update
```
Install the client packages.
```
sudo apt install postgresql-client
```

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.
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

Simply run:

sudo dnf install postgresql.x86_64

postgresql represents the PostgreSQL client programs including psql in DNF.

Was this page helpful?