The PostgreSQL Apt Repository now hosts installs of PostGIS, pgRouting, in addition to Postgresql and PGAdmin.
The following describes how to install Postgresql 10, PostGIS 2.4, pgRouting 2.6, PGAdmin on Ubuntu version 16.04. It is assumed to also work on Linux Mint, Lubuntu, and Xubuntu.
Run these in terminal:
Verify what version of Ubuntu you are running
sudo lsb_release -a
Add Respository to sources.list
You'll need to replace the nickname below with what you are running. Note to replace the word trusty with whatever version lsb states
Helper on http://www.postgresql.org/download/linux/ubuntu/
For xenial (16.04.4 LTS)
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt xenial-pgdg main" >> /etc/apt/sources.list'
Add Keys
wget --quiet -O - http://apt.postgresql.org/pub/repos/apt/ACCC4CF8.asc | sudo apt-key add -
sudo apt update
Install only commandline tools
If you only want the commandline tools and don't want to install the whole server or you want to use a newer version of the commandline tools (shp2pgsql, raster2pgsql)
sudo apt-cache policy postgis #gives list of versions # to install default version sudo apt install postgis --no-install-recommends #if you'd prefer to install a specific version where 2.4.3+dfsg-4 replace with your desired version from cache policy list sudo apt install postgis=2.4.3+dfsg-4 --no-install-recommends
Install
The following will install postgresql 10, PostGIS 2.4, PGAdmin4, pgRouting 2.6 and additional supplied modules including the adminpack extension:
sudo apt install postgresql-10 sudo apt install postgresql-10-postgis-2.4 sudo apt install postgresql-10-postgis-scripts #to get the commandline tools shp2pgsql, raster2pgsql you need to do this sudo apt install postgis
To get pgRouting
# Install pgRouting 2.6 package sudo apt install postgresql-10-pgrouting
Enable Adminpack
While in terminal, log in to the psql console as postgres user:
sudo -u postgres psql
CREATE EXTENSION adminpack;
Never install PostGIS in the postgres database, create a user database You can also enable the PostGIS extension here (or with the GUI as described below):
sudo -u postgres psql
CREATE DATABASE gisdb; \connect gisdb; CREATE SCHEMA postgis; ALTER DATABASE gisdb SET search_path=public, postgis, contrib; \connect gisdb; -- this is to force new search path to take effect CREATE EXTENSION postgis SCHEMA postgis; SELECT postgis_full_version();
should give you output something like this:
postgis_full_version ------------------------------------------------------------------------------------------------------------------------------------------------------ ----------------------------------------------------- POSTGIS="2.4.4 r16526" PGSQL="100" GEOS="3.6.2-CAPI-1.10.2 4d2925d6" PROJ="Rel. 4.9.3, 15 August 2016" GDAL="GDAL 2.2.3, released 2017/11/20" LIBXML= "2.9.4" LIBJSON="0.12.1" LIBPROTOBUF="1.2.1" RASTER
Installing postgis_sfcgal, if you need advanced 3D support
CREATE EXTENSION postgis_sfcgal SCHEMA postgis; SELECT postgis_full_version();
should give you:
postgis_full_version ------------------------------------------------------------------------------------------------------------------------------------------------------ -------------------------------------------------------------------- POSTGIS="2.4.4 r16526" PGSQL="100" GEOS="3.5.0-CAPI-1.9.0 r4084" SFCGAL="1.2.2" PROJ="Rel. 4.9.2, 08 September 2015" GDAL="GDAL 1.11.3, released 2015 /09/16" LIBXML="2.9.3" LIBJSON="0.11.99" LIBPROTOBUF="1.2.1" RASTER
Install pgRouting
CREATE EXTENSION pgrouting SCHEMA postgis; SELECT * FROM pgr_version();
should give you:
version | tag | hash | branch | boost ---------+--------+---------+-------------+-------- 2.6.0 | v2.6.0 | a6226c4 | release/2.6 | 1.65.1 (1 row)
Exit the psql console:
\q
Open Access to Clients
If you need to allow access from external, you can do this as well
sudo -u postgres psql
ALTER SYSTEM SET listen_addresses='*'; \q
You may need to edit to pg_hba.conf and/or pg_ident.conf to allow external access
sudo nano /etc/postgresql/10/main/pg_hba.conf
If you need external access, scroll to the bottom of the pg_hba.conf file and add a line like this (which will allow all clients with md5 password encrypt authentication (right after the local rules):
hostssl all all 0.0.0.0/0 md5
Click CTRL-X to save your changes, Y to write them to the file, and enter to exit.
If you change ip or port, you need to do a service restart.
sudo service postgresql restart
Note: you can also do from postgres psql console with below - only for changes that don't require restart)
SELECT pg_reload_conf();
Optional: check location of configuration files:
From the psql console(see above):
SELECT name, setting FROM pg_settings where category='File Locations';
Which will output something like:
name | setting -------------------+----------------------------------------- config_file | /etc/postgresql/10/main/postgresql.conf data_directory | /var/lib/postgresql/10/main external_pid_file | /var/run/postgresql/10-main.pid hba_file | /etc/postgresql/10/main/pg_hba.conf ident_file | /etc/postgresql/10/main/pg_ident.conf (5 rows)
Create new PGSQL user
You can create a new database super user to use instead of the default postgres user.
While in terminal, run:
sudo -u postgres psql CREATE ROLE mysuperuser LOGIN PASSWORD 'whatever' SUPERUSER;
Import SHP files using shp2pgsql-gui
Another handy piece of software shp2pgsql-gui tool. This will allow you to quickly connect to your new PostGIS database and import a Shapefile.
Note this will only work if you have Ubuntu with a desktop (not a headless Ubuntu)
Open terminal, and type:
sudo apt-get install postgis-gui
(Note: this is coming from the main Ubuntu software repository, as it seems the PostgreSQL APT repository doesn't package SHP2PGSQL-GUI anymore…)
Now open the SHP2PGSQL application:
shp2pgsql-gui
Follow the on-screen prompts to load your data.
For more information, visit the Boston GIS tutorial in the section "Load Towns Data"
ogr_fdw foreign data wrapper for spatial data
Unfortunately seems PostgreSQL Apt does not include ogr_fdw spatial data wrapper. The wrapper utilizes GDAL, so much of plumbing needed is already installed for you as part of PostGIS. Compiling isn't too difficult. On a vanilla Ubuntu, I was able to compile and install with following:
#for compiling ogr_fdw cd ~/ mkdir sources cd sources sudo apt-get install git sudo apt-get install postgresql-server-dev-9.6 sudo apt-get install make sudo apt-get install gcc sudo apt-get install libgdal1-dev sudo git clone -b master https://github.com/pramsey/pgsql-ogr-fdw.git pgsql_ogr_fdw cd pgsql_ogr_fdw export PATH=/usr/lib/postgresql/9.6/bin:$PATH make && make install
After you're done compiling and installing the binary, you can install the ogr_fdw extension in your database
sudo -u postgres psql
\connect gisdb;
CREATE EXTENSION ogr_fdw SCHEMA postgis;
CREATE SCHEMA IF NOT EXISTS staging ;
-- here I assume you have a file in root of /gis_data folder that postgres process has read rights to
-- any file that gdal can read will do e.g shape file, CSV, etc
CREATE SERVER svr_shp
FOREIGN DATA WRAPPER ogr_fdw
OPTIONS (
datasource '/gis_data',
format 'ESRI Shapefile' );
-- this will link in all your shapefile tables in folder gis_data as foreign tables
IMPORT FOREIGN SCHEMA ogr_all
FROM SERVER svr_shp INTO staging;
