How to install and use PgHero in Ubuntu Linux?

PgHero is a free and opensource dashboard for Postgres which shows system metrics such as resource usages, health checks etc. It offers web interface through which you can monitor how PostgreSQL database server is doing.

In this article I will discuss how to install and use PgHero in Ubuntu Linux.


To follow this article you should have the following –

  • A system running Ubuntu
  • Access to a user account with sudo priviledge

How to install PgHero in Ubuntu

For using PgHero we should have PostgreSQL installed on our system. Now follow the step below to install Postgresql and then PgHero on your system.

Installing PostgreSQL in Ubuntu

First, update the local package repository using the following command.

sudo apt update

Next, use the given command to install PostgreSQL in Ubuntu.

sudo apt install postgresql postgresql-contrib

Where postgresql-contrib package add some other functionalities that are not the part of postgresql package.

Press y and then enter to proceed with the installation process.

You can verify the installation by using –

psql -V

postgresql version

Use the following command to start and enable PostgreSQL services –

sudo systemctl start postgresql
sudo systemctl enable postgresql

Now use the given command to view PostgreSQL services are running or not –

sudo systemctl status postgresql


Creating a datebase

First change the default password of PostgreSQL database –

sudo passwd postgres

Now switch to postgres user by using –

su - postgres

Create a new user for PostgreSQL –

createuser newdbuser

Use the following command to access PostgreSQL database console –


Create a password for new user –

ALTER USER newdbuser WITH ENCRYPTED password 'Pass123';

Next create a database named newdb and set the owner to newdbuser.

CREATE DATABASE newdb OWNER newdbuser;

Grant all the required privileges to the user –


Now exit Postgres instance by using –


Use the given command to exit log back to your current user –


Installing PgHero in Ubuntu

Use the following command to download PgHero GPG key –

wget -qO- | sudo apt-key add -

Next use the given command to add the downloaded repository key to your system –

sudo wget -O /etc/apt/sources.list.d/pghero.list$(. /etc/os-release && echo $VERSION_ID).repo

Refersh the local package database –

sudo apt update

Finally run the given command to install PgHero –

sudo apt -y install pghero

Configuring PgHero

Before we use PgHero we need to do a some configurations. Define the database with database user name, database name and database password that you want to query.

sudo pghero config:set DATABASE_URL=postgres://dbuser:SecurePassword@localhost:5432/dbname

For example –

sudo pghero config:set DATABASE_URL=postgres://newdbuser:pass123@localhost:5432/newdb

Define the port through which PgHero will be accessed –

sudo pghero config:set PORT=3001

Add some more PgHero web server settings –

sudo pghero config:set RAILS_LOG_TO_STDOUT=disabled
sudo pghero scale web=1

Start and enable the PgHero services –

sudo systemctl start pghero
sudo systemctl enable pghero

Adjust firewall settings –

sudo ufw allow 3001/tcp
sudo ufw allow 80/tcp

Finally check if PgHero services are running or not –

sudo systemctl status pghero

pghero service status

Configuring Nginx reverse proxy

To setup Nginx as reverse proxy first run the given command to install Nginx –

sudo apt install -y nginx

Unlink the default Nginx configuration file –

sudo unlink /etc/nginx/sites-enabled/default

Create a new configuration file –

sudo nano /etc/nginx/sites-available/pghero.conf

Add the given lines to this file –

server {
    listen 80;

    location / {
        proxy_pass http://localhost:3001;

Replace the server_name with your own and save this file.

Enable the new configuration file by using –

sudo ln -s /etc/nginx/sites-available/pghero.conf /etc/nginx/sites-enabled/pghero.conf

Now restart Nginx services –

sudo service nginx restart

Accessing PgHero web interface

Once everything is setup correctly, open a web browser and type the given URL –


For example –


This will display output as given in the image below.

pghero web interface


So I hope you have successfully setup PgHero for performance monitoring of PostgreSQL database server. Now if you have a query then write us in the comments below.

Leave a Comment