Introduction
PostGIS is a full-fledged Geographic Information System (GIS) data modeling tool. It has many GIS-specific data types and functions. PostGIS is available as an extension for the PostgreSQL database; it is not a standalone software. This guide shows how to install PostGIS on PostgreSQL when installed on a Vultr cloud server or a Vultr Managed Database.
Prerequisites
Before starting with this guide, you should have:
- Either PostgreSQL installed on a Vultr cloud server, or a Vultr Managed Database for PostgreSQL
psql, which is an interactive terminal for PostgreSQL. It’s installed on the database server by default, or you can install PostgreSQL on a local workstation.- Experience with basic SQL commands.
- PostGIS is available only in the database where it has been loaded. Before loading the PostGIS extension, ensure that you are connected to the database in which you want to use PostGIS. To connect to a specific database, use: =# \c DATABASE_NAME
By default, a standalone PostgreSQL installation connects to the postgres database as the user postgres. An instance of Vultr Managed Databases for PostgreSQL connects to the defaultdb database as the user vultradmin. Following this guide without explicitly connecting to a specific database will load PostGIS into the default database.
Note that =# refers to the PostgreSQL psql prompt, # refers to the root prompt on the operating system, and $ refers to a regular user prompt.
Compatibility
The instructions in this guide are based on PostgreSQL version 14 and PostGIS 3.2 running on Ubuntu 22.04 and Vultr Managed Databases for PostgreSQL. They should be compatible with all recent versions of the software and operating systems. Note that in the case of standalone servers, you need to have only one version of PostgreSQL installed. Handling two or more versions installed on the same system is beyond the scope of this guide
Step 1: Install Packages for PostGIS
Assuming that PostgreSQL is already available, PostGIS installation consists of 2 steps:
- Install
postgis, the PostGIS package, from the operating system’s package manager. - Load PostGIS into a PostgreSQL database.
While this guide demonstrates the first step for Ubuntu, the general procedure is the same for all operating systems. The second step is the same for both standalone servers as well as Vultr Managed Databases for PostgreSQL.
Option 1 – Install on Ubuntu
Optional – Check Compatibility
In general, there should be no compatibility issues on Ubuntu. Check the version of PostgreSQL installed on your operating system. On the PostgreSQL command line, enter:
=# SELECT version();
Code language: PHP (php)Check the version of PostGIS available on the apt package manager:
$ apt search ^postgis$
Check the compatibility page to ensure the available version of PostGIS is compatible with the installed version of PostgreSQL.
Install the Package
Install the postgis package on Ubuntu using the apt package manager.
# apt install postgis
Code language: PHP (php)This will install the latest version of PostGIS available for the operating system.
Option 2 – Install on Vultr Managed Databases for PostgreSQL
On Vultr Managed Databases for PostgreSQL, the PostGIS extension package is already installed. You only need to load it (as shown in the next step).
Step 2: Load the PostGIS Extension
The second step of the installation is the same across both standalone servers and managed databases. Log in to the PostgreSQL command line using the psql tool, pgAdmin, or another front-end tool that allows you to issue queries to the PostgreSQL server. For Vultr Managed Databases for PostgreSQL, find the credentials from the Connection Details page of your instance.
Check Availability
Check if the extension is available to be loaded:
=# SELECT * FROM pg_available_extensions;
Code language: PHP (php)After installing PostGIS on the operating system, it should be included in this list.
Load the Extension
Use the CREATE EXTENSION command of PostgreSQL to create a new extension for PostGIS:
=# CREATE EXTENSION postgis ;
Code language: PHP (php)The PostGIS extension should now be loaded into the database.
Check Installation
Check that the PostGIS extensions are loaded:
=# SELECT * FROM pg_extension ;
Code language: PHP (php)The above command shows the list of all loaded extensions. You can also check the version of PostGIS installed:
=# SELECT postgis_version();
Code language: PHP (php)Conclusion
PostGIS has now been loaded into your PostgreSQL database. The PostGIS documentation is a good starting point to learn more about how to handle GIS data in PostgreSQL.
