How to Install Postgresql on Ubuntu

LightNode
By LightNode ·

Introduction

PostgreSQL, often simply referred to as Postgres, is a powerful, open-source object-relational database system. With more than 30 years of active development, PostgreSQL has earned a strong reputation for its reliability, feature robustness, and performance.

Installing PostgreSQL on Ubuntu is a popular choice for many developers and database administrators due to several compelling reasons:

  1. Compatibility: Ubuntu, being one of the most widely used Linux distributions, offers excellent compatibility with PostgreSQL.

  2. Performance: The combination of Ubuntu's efficiency and PostgreSQL's robust architecture results in high-performance database operations.

  3. Security: Both Ubuntu and PostgreSQL are known for their strong security features, making this combination ideal for handling sensitive data.

  4. Community Support: Both Ubuntu and PostgreSQL have large, active communities, ensuring that help is readily available when needed.

  5. Free and Open-Source: Both systems are free to use and open-source, allowing for cost-effective deployment and the ability to customize if needed.

This guide will walk you through the process of installing PostgreSQL on your Ubuntu system, from preparation to basic usage. Whether you're setting up a development environment or preparing a production server, this tutorial will provide you with the necessary steps to get PostgreSQL up and running on Ubuntu.

Prerequisites

Before we begin the installation process, it's important to ensure that your system meets the necessary requirements and that you have the appropriate permissions. Let's go through the prerequisites:

Ubuntu System Requirements

  1. Ubuntu Version: This guide is applicable for Ubuntu 20.04 LTS (Focal Fossa) and newer versions. However, it's always recommended to use the latest Long Term Support (LTS) version for stability.

  2. System Resources: PostgreSQL can run on systems with limited resources, but for optimal performance, consider the following recommendations:

    • CPU: 1 GHz or faster processor
    • RAM: At least 1 GB (4 GB or more recommended for production use)
    • Storage: 512 MB for PostgreSQL installation, plus additional space for your databases
  3. Internet Connection: You'll need an active internet connection to download PostgreSQL and its dependencies.

User Permissions

To install PostgreSQL, you'll need sudo privileges on your Ubuntu system. This means you should either be logged in as the root user or have an account that can use sudo to execute commands with root privileges.

To check if your user has sudo privileges, you can run the following command in the terminal:

sudo -v

If you're prompted for a password and the command executes without any errors, your user has sudo privileges.

Terminal Access

You should be comfortable using the command line interface (CLI) as we'll be using the terminal for most of the installation and configuration process.

Backup Your Data

If you're installing PostgreSQL on a system that already has important data, it's always a good practice to back up your data before proceeding with any major software installation.

Updating the System

Before installing PostgreSQL, it's crucial to ensure that your Ubuntu system is up to date. This step is important for several reasons:

  1. Security: Updates often include important security patches.
  2. Stability: The latest updates can fix bugs and improve system stability.
  3. Compatibility: Having the latest packages can prevent potential compatibility issues during the PostgreSQL installation.

Steps to Update Ubuntu

To update your Ubuntu system, follow these steps:

  1. Open your terminal. You can do this by pressing Ctrl + Alt + T or by searching for "Terminal" in the Ubuntu dashboard.

  2. First, update the package lists for upgrades and new package installations. Run the following command:

    sudo apt update
    

    This command refreshes the list of available packages and their versions, but it doesn't install or upgrade any packages.

  3. After the update is complete, upgrade the installed packages to their latest versions:

    sudo apt upgrade
    

    This command will show you a list of packages that are about to be upgraded. Press 'Y' and then 'Enter' to confirm and proceed with the upgrade.

  4. Optionally, you can run a full system upgrade, which will also intelligently handle changing dependencies with new versions of packages:

    sudo apt full-upgrade
    

    Be cautious with this command as it may remove some packages if needed to upgrade others.

  5. After the upgrade process is complete, it's a good idea to reboot your system to ensure all updates are properly applied:

    sudo reboot
    

Verifying the Update

After your system reboots, you can verify that the update was successful by checking the Ubuntu version:

lsb_release -a

This command will display information about your Ubuntu distribution, including the version number.

Adding PostgreSQL Repository

While PostgreSQL is available in Ubuntu's default repositories, it's often not the latest version. To ensure we install the most recent stable version of PostgreSQL, we'll add the official PostgreSQL repository to our system.

Why Add the Official PostgreSQL Repository?

  1. Latest Versions: The official repository provides the most up-to-date versions of PostgreSQL.
  2. Timely Updates: Security patches and bug fixes are available sooner through the official repository.
  3. Consistency: Using the official repository ensures compatibility between PostgreSQL and its extensions.

Steps to Add the PostgreSQL Repository

Follow these steps to add the PostgreSQL repository to your Ubuntu system:

  1. First, we need to add the PostgreSQL signing key. This key is used to verify that the packages we're about to install are authentic. Run the following command:

    sudo apt-get install wget ca-certificates
    wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
    
  2. Next, we need to add the PostgreSQL repository to our system's source list. Create a new file named pgdg.list in the /etc/apt/sources.list.d/ directory:

    sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
    

    This command creates a new file with the repository information. The $(lsb_release -cs) part automatically detects your Ubuntu version and inserts the correct codename.

  3. After adding the repository, update the package lists again to include the newly added PostgreSQL repository:

    sudo apt update
    

Verifying the Repository Addition

To verify that the PostgreSQL repository has been successfully added, you can check the contents of the pgdg.list file:

cat /etc/apt/sources.list.d/pgdg.list

You should see a line similar to:

deb http://apt.postgresql.org/pub/repos/apt focal-pgdg main

(Note: "focal" might be replaced with your Ubuntu version's codename)

Installing PostgreSQL

Now that we have added the PostgreSQL repository and updated our system, we're ready to install PostgreSQL. This process is straightforward and can be completed with a few simple commands.

Command to Install PostgreSQL

To install PostgreSQL, we'll use the apt package manager. Here's the command to install the latest version of PostgreSQL along with a commonly used extension:

sudo apt install postgresql postgresql-contrib

Let's break down this command:

  • postgresql: This is the core PostgreSQL package.
  • postgresql-contrib: This package contains additional utilities and functionality that are not part of the core PostgreSQL system but are often useful.

During the installation process, you might be prompted to confirm the installation. If so, type 'Y' and press Enter to proceed.

Verifying the Installation

After the installation is complete, it's important to verify that PostgreSQL was installed correctly and is running. Here are a few ways to do this:

  1. Check the PostgreSQL version:

    psql --version
    

    This should display the version of PostgreSQL that was installed.

  2. Check the status of the PostgreSQL service:

    sudo systemctl status postgresql
    

    You should see output indicating that the service is active (running).

  3. Verify that PostgreSQL is listening for connections:

    sudo ss -tunelp | grep 5432
    

    This command checks if PostgreSQL is listening on its default port (5432). You should see output if PostgreSQL is running correctly.

Initial PostgreSQL Setup

When you install PostgreSQL on Ubuntu, it automatically creates a new user account called postgres. This account is associated with the default Postgres role. To interact with PostgreSQL using this account, you can switch to it like this:

sudo -i -u postgres

Then, you can access the PostgreSQL prompt by typing:

psql

This will log you into the PostgreSQL prompt, and you'll see something like:

psql (13.x)
Type "help" for help.

postgres=#

To exit the PostgreSQL prompt, type:

\q

And to return to your regular user account, simply type:

exit

Congratulations! You have successfully installed PostgreSQL on your Ubuntu system. In the next section, we'll cover how to configure PostgreSQL for your needs.

Configuring PostgreSQL

After installing PostgreSQL, it's important to configure it properly for your needs. This section will cover creating a new database, setting up a new user, and configuring authentication methods.

Creating a New Database

By default, PostgreSQL creates a database called postgres. However, it's a good practice to create separate databases for your projects. Here's how to create a new database:

  1. Switch to the postgres user:

    sudo -i -u postgres
    
  2. Access the PostgreSQL prompt:

    psql
    
  3. Create a new database using the CREATE DATABASE command:

    CREATE DATABASE myproject;
    

    Replace myproject with your desired database name.

  4. You can verify the database creation with:

    \l
    

    This will list all databases.

Setting Up a New User

It's recommended to create a new user for each application rather than using the default postgres superuser. Here's how:

  1. While still in the psql prompt, create a new user:

    CREATE USER myuser WITH PASSWORD 'mypassword';
    

    Replace myuser and mypassword with your desired username and password.

  2. Grant privileges to the new user on the new database:

    GRANT ALL PRIVILEGES ON DATABASE myproject TO myuser;
    
  3. You can verify user creation with:

    \du
    

    This will list all users and their roles.

Configuring Authentication Methods

PostgreSQL uses different authentication methods which are configured in the pg_hba.conf file. Here's how to modify it:

  1. Exit the PostgreSQL prompt:

    \q
    
  2. Open the pg_hba.conf file with a text editor (you might need sudo privileges):

    sudo nano /etc/postgresql/13/main/pg_hba.conf
    

    Note: Replace 13 with your PostgreSQL version number if different.

  3. The file contains lines that determine how users can authenticate. A typical configuration might look like this:

    # TYPE  DATABASE        USER            ADDRESS                 METHOD
    local   all             postgres                                peer
    local   all             all                                     md5
    host    all             all             127.0.0.1/32            md5
    host    all             all             ::1/128                 md5
    
    • local means connecting through Unix domain sockets
    • host means connecting through TCP/IP
    • md5 means password authentication
    • peer means the system user name maps directly to a PostgreSQL user name
  4. After making changes, save the file and exit the editor.

  5. Restart PostgreSQL for the changes to take effect:

    sudo systemctl restart postgresql
    

Remember, these are basic configurations. Depending on your specific needs, you might need to adjust settings further, especially for production environments where security is crucial.

Basic PostgreSQL Commands

Now that we have PostgreSQL installed and configured, let's explore some basic commands that will help you interact with your databases. These commands are essential for managing databases, tables, and performing basic operations.

Connecting to PostgreSQL

  1. Connect as the postgres user:

    sudo -i -u postgres
    
  2. Start the PostgreSQL interactive terminal:

    psql
    
  3. To connect to a specific database:

    psql -d myproject
    

    Replace myproject with your database name.

Database Operations

  1. List all databases:

    \l
    
  2. Connect to a specific database:

    \c myproject
    
  3. Create a new database:

    CREATE DATABASE newdb;
    
  4. Delete a database:

    DROP DATABASE newdb;
    

Table Operations

  1. List tables in the current database:

    \dt
    
  2. Create a new table:

    CREATE TABLE users (
        id SERIAL PRIMARY KEY,
        name VARCHAR(100),
        email VARCHAR(100) UNIQUE NOT NULL
    );
    
  3. Describe a table structure:

    \d users
    
  4. Delete a table:

    DROP TABLE users;
    

Basic Query Examples

  1. Insert data into a table:

    INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]');
    
  2. Select all data from a table:

    SELECT * FROM users;
    
  3. Update data in a table:

    UPDATE users SET name = 'Jane Doe' WHERE id = 1;
    
  4. Delete data from a table:

    DELETE FROM users WHERE id = 1;
    

Other Useful Commands

  1. Show PostgreSQL version:

    SELECT version();
    
  2. List all users and their roles:

    \du
    
  3. Show current user and database:

    \conninfo
    
  4. Execute commands from a file:

    \i filename.sql
    
  5. Quit psql:

    \q
    

Remember, these are just basic commands to get you started. PostgreSQL offers a wide range of advanced features and commands for more complex operations and optimizations.

Maintaining PostgreSQL

Proper maintenance of your PostgreSQL installation is crucial for ensuring optimal performance, data integrity, and security. This section covers some essential maintenance tasks you should be familiar with.

Starting and Stopping the PostgreSQL Service

  1. To start the PostgreSQL service:

    sudo systemctl start postgresql
    
  2. To stop the PostgreSQL service:

    sudo systemctl stop postgresql
    
  3. To restart the PostgreSQL service:

    sudo systemctl restart postgresql
    
  4. To check the status of the PostgreSQL service:

    sudo systemctl status postgresql
    

Backing Up and Restoring Databases

Regularly backing up your databases is crucial for data protection. PostgreSQL provides several methods for backup and restoration.

Creating a Backup

  1. To backup a single database:

    pg_dump dbname > dbname.sql
    
  2. To backup all databases:

    pg_dumpall > all_databases.sql
    

Restoring from a Backup

  1. To restore a single database:

    psql dbname < dbname.sql
    
  2. To restore all databases:

    psql -f all_databases.sql postgres
    

Updating PostgreSQL

Keeping PostgreSQL updated is important for security and performance. Here's how to update:

  1. Update the package list:

    sudo apt update
    
  2. Upgrade PostgreSQL:

    sudo apt upgrade postgresql postgresql-contrib
    

Monitoring PostgreSQL

  1. Check active connections:

    SELECT * FROM pg_stat_activity;
    
  2. Monitor database size:

    SELECT pg_size_pretty(pg_database_size('dbname'));
    
  3. Check table sizes:

    SELECT relname, pg_size_pretty(pg_total_relation_size(relid))
    FROM pg_catalog.pg_statio_user_tables
    ORDER BY pg_total_relation_size(relid) DESC;
    

Vacuum and Analyze

PostgreSQL uses MVCC (Multi-Version Concurrency Control), which can lead to bloat in tables and indexes. The VACUUM command helps manage this:

  1. To vacuum a specific table:

    VACUUM tablename;
    
  2. To vacuum and analyze (updates statistics) a database:

    VACUUM ANALYZE;
    
  3. For automated vacuum, ensure autovacuum is enabled in your postgresql.conf file:

    autovacuum = on
    

Log Management

PostgreSQL logs can provide valuable information for troubleshooting and performance tuning:

  1. Find the log file location:

    SHOW log_directory;
    SHOW log_filename;
    
  2. You can modify logging settings in the postgresql.conf file to adjust what gets logged and how.

Remember, these are basic maintenance tasks. For production environments, you might need more advanced strategies, including setting up replication, load balancing, and implementing more sophisticated backup and monitoring solutions.

Troubleshooting Common Issues

Even with careful setup and maintenance, you may encounter issues with your PostgreSQL installation. Here are some common problems and their solutions:

Permission Problems

  1. Issue: "Permission denied" errors when trying to access PostgreSQL.

    Solution:

    • Ensure the user has the necessary permissions:
      sudo -i -u postgres
      createuser --interactive
      
    • Grant necessary privileges to the user:
      GRANT ALL PRIVILEGES ON DATABASE mydb TO myuser;
      
  2. Issue: Can't access PostgreSQL with your Ubuntu user.

    Solution:

    • Create a PostgreSQL role with the same name as your Ubuntu user:
      sudo -u postgres createuser --interactive
      

Connection Issues

  1. Issue: "Connection refused" error.

    Solution:

    • Check if PostgreSQL is running:
      sudo systemctl status postgresql
      
    • If it's not running, start it:
      sudo systemctl start postgresql
      
    • Ensure PostgreSQL is listening on the correct address in postgresql.conf:
      listen_addresses = 'localhost'  # or '*' for all interfaces
      
  2. Issue: Can't connect remotely.

    Solution:

    • Modify pg_hba.conf to allow remote connections:
      host    all    all    0.0.0.0/0    md5
      
    • Update postgresql.conf:
      listen_addresses = '*'
      
    • Restart PostgreSQL:
      sudo systemctl restart postgresql
      

Version Conflicts

  1. Issue: Incompatibility between PostgreSQL version and installed extensions.

    Solution:

    • Check PostgreSQL version:
      psql --version
      
    • Ensure extensions are compatible. You may need to upgrade extensions:
      ALTER EXTENSION extension_name UPDATE TO 'new_version';
      

Performance Issues

  1. Issue: Slow queries or overall poor performance.

    Solution:

    • Use EXPLAIN ANALYZE to understand query execution:
      EXPLAIN ANALYZE SELECT * FROM large_table WHERE condition;
      
    • Ensure proper indexing:
      CREATE INDEX idx_name ON table_name (column_name);
      
    • Adjust PostgreSQL configuration parameters in postgresql.conf:
      shared_buffers = 256MB
      effective_cache_size = 768MB
      
  2. Issue: Database bloat causing performance degradation.

    Solution:

    • Run VACUUM and ANALYZE regularly:
      VACUUM ANALYZE;
      
    • Consider setting up autovacuum for automatic maintenance.

Disk Space Issues

  1. Issue: Running out of disk space.

    Solution:

    • Identify large tables and indexes:
      SELECT relname, pg_size_pretty(pg_total_relation_size(relid))
      FROM pg_catalog.pg_statio_user_tables
      ORDER BY pg_total_relation_size(relid) DESC;
      
    • Remove unnecessary data or archive old data.
    • Consider table partitioning for very large tables.

Remember, these are general solutions. The exact steps may vary depending on your specific PostgreSQL version and system configuration. Always backup your data before making significant changes to your database or its configuration.

Install PostgreSQL on Ubuntu

Frequently Asked Questions (FAQ)

Q: How do I find out which version of PostgreSQL I'm running?

A: You can use the following command in the terminal:

psql --version

Or, if you're already in the psql prompt:

SELECT version();

Q: Can I have multiple versions of PostgreSQL installed on the same Ubuntu system?

A: Yes, it's possible to have multiple versions installed. However, you need to manage the ports and data directories carefully to avoid conflicts.

Q: How do I change the PostgreSQL user password?

A: You can change the password using the following SQL command:

ALTER USER username WITH PASSWORD 'new_password';

Q: How can I enable remote access to my PostgreSQL server?

A: You need to modify the postgresql.conf and pg_hba.conf files. In postgresql.conf, set listen_addresses = '*', and in pg_hba.conf, add a line like host all all 0.0.0.0/0 md5. Remember to restart PostgreSQL after making these changes.

Q: What's the difference between TRUNCATE and DELETE in PostgreSQL?

A: TRUNCATE is faster as it removes all rows in a table without scanning them individually. DELETE removes rows one by one and records the deletions in the transaction log. TRUNCATE also resets sequences and doesn't trigger DELETE triggers.

Q: How can I improve PostgreSQL performance?

A: Some ways to improve performance include:

  • Proper indexing
  • Regular VACUUM and ANALYZE
  • Optimizing queries
  • Adjusting PostgreSQL configuration parameters
  • Upgrading hardware (especially adding more RAM)