How to Install PostgreSQL and pgAdmin in CentOS 8

PostgreSQL is a powerful, widely-used, open-source, multi-platform and advanced object-relational database system known for its proven architecture, reliability, data integrity, robust feature set, and extensibility.

pgAdmin is an advanced, open-source, full-featured, and web-based administration and management tool for the PostgreSQL database server.

In this article, you will learn how to install the PostgreSQL 12 database server and pgAdmin 4 in CentOS 8 Linux distribution.

Step 1: Installing PostgreSQL on CentOS 8

1. First, disable the built-in PostgreSQL module by running the following dnf command.

# dnf -qy module disable postgresql

2. Next, enable the official PostgreSQL Yum Repository as shown.

# dnf install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

3. Next, install the PostgreSQL 12 server and client packages.

# dnf install postgresql12 postgresql12-server
Install PostgreSQL on CentOS 8

Install PostgreSQL on CentOS 8

4. Once the installation is complete, initialize the PostgreSQL database, then start the PostgreSQL-12 service and enable it to automatically start at system boot. Then check if the service is up and running, and is enabled as shown.

# /usr/pgsql-12/bin/postgresql-12-setup initdb 
# systemctl start postgresql-12
# systemctl enable postgresql-12
# systemctl status postgresql-12
# systemctl is-enabled postgresql-12
Initialize PostgreSQL Database

Initialize PostgreSQL Database

Step 2: Secure and Configure PostgreSQL Database

5. Next, secure the Postgres user account and the database administrative user account. Start by creating a password for a Postgres system user account using the passwd utility as shown.

# passwd postgres
Set PostgreSQL User Password

Set PostgreSQL User Password

6. Then switch to the Postgres system account and create a secure and strong password for PostgreSQL administrative database user/role as follows.

# su - postgres
$ psql -c "ALTER USER postgres WITH PASSWORD '[email protected]';"
$ exit
Set PostgreSQL Admin Password

Set PostgreSQL Admin Password

7. Now configure how the Postgres server will authenticate clients such as pgAdmin. The supported authentication methods include password-based authentication which uses one of these methods: md5, crypt, or password.

For this guide, we will configure md5 authentication method in the file /var/lib/pgsql/12/data/pg_hba.conf.

# vi /var/lib/pgsql/12/data/pg_hba.conf

Find the following lines and change the authentication method to md5 as highlighted in the screenshot.

host    all             all             127.0.0.1/32            md5
host    all             all             ::1/128                 md5
Configure PostgreSQL Client Authentication

Configure PostgreSQL Client Authentication

8. After saving the file, to apply the recent changes in the Postgres configuration, restart the Postgres service.

  
# systemctl restart postgresql-12

Step 3: Installing pgAdmin4 in CentOS 8

9. Now we will install pgAdmin 4 to manage the PostgreSQL database from the web. First, you need to enable the EPEL and PowerTools repositories which contain some of the dependencies.

# dnf install epel-release
# dnf --enablerepo=PowerTools install pgadmin4
Install PgAdmin in CentOS 8

Install PgAdmin in CentOS 8

10. Next, start the httpd service and enable it to auto-start at system boot, then check if it is up and running as shown.

# systemctl start httpd
# systemctl enable httpd
# systemctl status httpd

Step 4: Configuring pgAdmin 4 in CentOS 8

11. Now create a configuration file for pgAdmin4 under the httpd configuration structure. Create a new configuration file from the provided sample as shown.

# cp /etc/httpd/conf.d/pgadmin4.conf.sample /etc/httpd/conf.d/pgadmin4.conf

12. Next, ensure that the httpd configuration syntax is ok, and restart the service.

# httpd -t
# systemctl restart httpd
Check HTTPD Configuration

Check HTTPD Configuration

13. Now you need to create a directory for pgAdmin logs and libraries by running the following commands.

# mkdir -p /var/lib/pgadmin4/
# mkdir -p /var/log/pgadmin4/

14. Then declare the location/path of the log file, SQLite database, session database and storage in the Python configuration file for pgAdmin in the file.

# vi /usr/lib/python3.6/site-packages/pgadmin4-web/config_distro.py

Copy and paste the following lines in the file.

LOG_FILE = '/var/log/pgadmin4/pgadmin4.log'
SQLITE_PATH = '/var/lib/pgadmin4/pgadmin4.db'
SESSION_DB_PATH = '/var/lib/pgadmin4/sessions'
STORAGE_DIR = '/var/lib/pgadmin4/storage'
Configure PgAdmin

Configure PgAdmin

15. Now create a user account used to authenticate in the web interface and also create the configuration database.

# python3 /usr/lib/python3.6/site-packages/pgadmin4-web/setup.py
Create PgAdmin Web User

Create PgAdmin Web User

16. Next, set the required ownership of the pgAdmin directories created recently.

# chown -R apache:apache /var/lib/pgadmin4
# chown -R apache:apache /var/log/pgadmin4

17. If you have SELinux enabled, also set the correct SELinux context of the pgAdmin log directories. And allow HTTPD scripts and modules (pgAdmin in this case)to connect to the network.

 
# chcon -t httpd_sys_rw_content_t /var/log/pgadmin4 -R
# chcon -t httpd_sys_rw_content_t /var/lib/pgadmin4 -R
# setsebool -P httpd_can_network_connect 1

18. Now restart the httpd service to apply all the recent changes.

# systemctl restart httpd

18. If you have the firewalld service enabled and running, open port 80 and 443 in the firewall to allow traffic to the HTTPD web server as shown.

# firewall-cmd --permanent --zone public --add-port 80/tcp
# firewall-cmd --permanent --zone public --add-port 443/tcp
# firewall-cmd --reload

Step 5: Accessing pgAdmin Web Interface

19. To access the pgAdmin web interface, open a browser and navigate using the following URL.

http://SERVER_IP/pgadmin4
OR
http://localhost/pgadmin4

Once the login interface loads, use the email address and password you created in step 15 above to log in.

PgAdmin Web Console

PgAdmin Web Console

20. Next, add a new server connection clicking on “Add New Server”.

Add New Server in PgAdmin

Add New Server in PgAdmin

21. Then under the “General” tab, enter the following settings server Name and optionally leave a comment to describe the connection.

Enter Server Name

Enter Server Name

22. Then define the connection profile by filling in the following:

  • Host – host/IP address of the PostgreSQL server.
  • Port – defaults to 5432.
  • Maintenance Database – defaults should be Postgres.
  • Username – the database username. You can use Postgres.
  • Password – password for the above user.

Then click Save.

Define Connection Profile

Define Connection Profile

23. The new server should now appear under the list of servers as highlighted in the following screenshot.

New Server Details

New Server Details

24. When you click on the server name, its attributes should load under the Dashboard as shown in the following screenshot.

PgAdmin Server Dashboard

PgAdmin Server Dashboard

There you have it! You have successfully installed Postgresql 12 and pgAdmin 4 in CentOS 8. Reach us via the feedback form below for any thoughts and questions. You can find more information in the Postgresql 12 documentation and pgAdmin documentation.

If You Appreciate What We Do Here On TecMint, You Should Consider:

TecMint is the fastest growing and most trusted community site for any kind of Linux Articles, Guides and Books on the web. Millions of people visit TecMint! to search or browse the thousands of published articles available FREELY to all.

If you like what you are reading, please consider buying us a coffee ( or 2 ) as a token of appreciation.

Support Us

We are thankful for your never ending support.

Aaron Kili

Aaron Kili is a Linux and F.O.S.S enthusiast, an upcoming Linux SysAdmin, web developer, and currently a content creator for TecMint who loves working with computers and strongly believes in sharing knowledge.

Your name can also be listed here. Got a tip? Submit it here to become an TecMint author.

RedHat RHCE and RHCSA Certification Book
Linux Foundation LFCS and LFCE Certification Preparation Guide
The Complete Linux System Administrator Bundle
Become an Ethical Hacker Bonus Bundle

You may also like...

2 Responses

  1. Humbert says:

    Hi Aaron, thanks for your tutorial it was very helpful, just one step that you need to change in step 15 if you have python3, just you need to use this line “python3 /usr/lib/python3.6/site-packages/pgadmin4-web/setup.py” to set up the pgadmin4.

Got something to say? Join the discussion.

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.