How to Install PostgreSQL database server on Debian 10

How to Install PostgreSQL database server on Debian 10

This tutorial walks you through the steps of installing the PostgreSQL database server on Debian 10\. We'll also explore the fundamentals of basic database administration.

PostgreSQL, often known simply as Postgres, is an open-source general-purpose object-relational database management system. It has many powerful features such as online backups, point in time recovery, nested transactions, SQL and JSON querying, multi-version concurrency control (MVCC), asynchronous replication, and more. This tutorial walks you through the steps of installing the PostgreSQL database server on Debian 10. We'll also explore the fundamentals of basic database administration.

Installing PostgreSQL

At the time of writing this article, the latest version of PostgreSQL available from the default Debian repositories is PostgreSQL version 11.5.

To install PostgreSQL on your Debian server perform the following steps as root or user with sudo privileges:

  1. Start by updating the APT package index:

    sudo apt update
  2. Install the PostgreSQL server and contrib package which provides additional features for the PostgreSQL database:

    sudo apt install postgresql postgresql-contrib
  3. Once the installation is complete, the PostgreSQL service will start. To verify the installation, use the psql tool to print the server version:

    sudo -u postgres psql -c "SELECT version();"

    The output should look something like the following:

    PostgreSQL 11.5 (Debian 11.5-1+deb10u1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 8.3.0-6) 8.3.0, 64-bit

PostgreSQL Roles and Authentication Methods

PostgreSQL handles database access permissions using the concept of roles. Depending on how you set up the role, it can represent a database user or a group of database users.

PostgreSQL supports several authentication methods. The most frequently used methods are:

  • Trust - A role can connect without a password, as long as the criteria defined in the pg_hba.conf are met.
  • Password - A role can connect by providing a password. The passwords can be stored as scram-sha-256``md5andpassword (clear-text)
  • Ident - Only supported for TCP/IP connections. It works by obtaining the client's operating system user name, with an optional user name mapping.
  • Peer - Same as Ident, but it is only supported on local connections.

PostgreSQL client authentication is defined in the configuration file named pg_hba.conf. For local connections, PostgreSQL is set to use the peer authentication method.

The “postgres” user is automatically created when PostgreSQL is installed. This user is the superuser for the PostgreSQL instance, and it is equivalent to the MySQL root user.

To log in to the PostgreSQL server as “postgres”, switch to the user postgres and access a PostgreSQL prompt using the psql utility:

sudo su - postgres

From here you can interact with the PostgreSQL server. To exit out of the PostgreSQL shell type:


You can use the sudo command to access the PostgreSQL prompt without switching users:

sudo -u postgres psql

The postgres user is typically used only from the localhost.

Creating PostgreSQL Role and Database

The createuser command allows you to create new roles from the command line. Only superusers and roles with CREATEROLE privilege can create new roles.

In the following example, we'll create a new role named kylo, a database named kylodb and grant privileges on the database to the role.

  1. First, create the role by issuing the following command:

    sudo su - postgres -c "createuser kylo"
  2. Next, create the database using the createdb command:

    sudo su - postgres -c "createdb kylodb"
  3. To grant permissions to the user on the database, connect to the PostgreSQL shell:

    sudo -u postgres psql

    Run the following query:

grant all privileges on database kylodb to kylo;

Enable Remote Access to the PostgreSQL Server

By default, the PostgreSQL, server listens only on the local interface

If you want to connect to the PostgreSQL server from remote locations, you need to set the server to listen on the public interface and edit the configuration to accept remote connections.

Open the configuration file postgresql.conf and add listen_addresses = '*' in the CONNECTIONS AND AUTHENTICATION section. This instruct the server to listen on all network interfaces.

sudo nano /etc/postgresql/11/main/postgresql.conf



# - Connection Settings -

listen_addresses = '*'     # what IP address(es) to listen on;

Save the file and restart the PostgreSQL service for changes to take effect:

sudo service postgresql restart

Verify the changes with the ss utility:

ss -nlt | grep 5432
LISTEN   0         128          *
LISTEN   0         128                    [::]:5432                [::]:*

The output should show that the PostgreSQL server listens on all interfaces (

The last step is to configure the server to accept remote logins by editing the pg_hba.conf file.

Below are some examples showing different use cases:


# TYPE  DATABASE        USER            ADDRESS                 METHOD

# The user jane will be able to access all databases from all locations using an md5 password
host    all             jane                  md5

# The user jane will be able to access only the janedb from all locations using an md5 password
host    janedb          jane                  md5

# The user jane will be able to access all databases from a trusted location ( without a password
host    all             jane              trust


We've shown you how to install and configure PostgreSQL on Debian 10. For more information on this topic, consult the PostgreSQL Documentation.

Thank you for reading !

postgresql debian database

Bootstrap 5 Complete Course with Examples

Bootstrap 5 Tutorial - Bootstrap 5 Crash Course for Beginners

Nest.JS Tutorial for Beginners

Hello Vue 3: A First Look at Vue 3 and the Composition API

Building a simple Applications with Vue 3

Deno Crash Course: Explore Deno and Create a full REST API with Deno

How to Build a Real-time Chat App with Deno and WebSockets

Convert HTML to Markdown Online

HTML entity encoder decoder Online

ScaleGrid DigitalOcean Support for MySQL, PostgreSQL and Redis™

ScaleGrid announces support for their fully managed hosting plans on DigitalOcean for MySQL, PostgreSQL and Redis™. See how developers can improve performance. MySQL and PostgreSQL are the top two open source relational databases in the world, and Redis is the top key-value database

PostgreSQL Tutorial - Learn PostgreSQL Database from Scratch

PostgreSQL Tutorial - Learn PostgreSQL Database from Scratch. Learn how to use PostgreSQL in this full course. PostgreSQL is a general purpose and object-relational database management system. It is the most advanced open source database system widely used to build back-end systems. What is a Database? What is SQL And Relational Database? What is PostreSQL AKA Postrgres? PostgreSQL Installation. How to Create Database.

Database Indexing Explained (with PostgreSQL)

Database Indexing Explained (with PostgreSQL). This is a practical video on Database Indexing where I explain what is an index, why do we need it and how it can improve the performance of the queries. Also how (if used incorrectly) it can slow down your queries

PostgreSQL Database Administration (DBA) for Beginners

Learn Database Administration - PostgreSQL Database Administration (DBA) for Beginners, we will go over the basics of the PostgreSQL. We will cover topics ranging from installations, to writing basic queries and retrieving data from tables. We will also explore the logic of joining tables to retrieve data and much more.