jonnybbb / docker-postgis

Docker image for PostGIS

Home Page:https://registry.hub.docker.com/u/mdillon/postgis/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

jonnybbb/postgis

The jonnybbb/postgis image provides a Docker container running Postgres with PostGIS 2.5 installed and locales for de, fr, it, en. This image is based on the official postgres image and provides variants for each version of the base image Postgres 10, and Postgres 11.

This image ensures that the default database created by the parent postgres image will have the following extensions installed:

  • postgis
  • locales for en, de, fr it

Unless -e POSTGRES_DB is passed to the container at startup time, this database will be named after the admin user (either postgres or the user specified with -e POSTGRES_USER). If you would prefer to use the older template database mechanism for enabling PostGIS, the image also provides a PostGIS-enabled template database called template_postgis.

Usage

In order to run a basic container capable of serving a PostGIS-enabled database, start a container as follows:

docker run --name some-postgis -e POSTGRES_PASSWORD=mysecretpassword -d jonnybbb/postgis

For more detailed instructions about how to start and control your Postgres container, see the documentation for the postgres image here.

Once you have started a database container, you can then connect to the database as follows:

docker run -it --link some-postgis:postgres --rm postgres \
    sh -c 'exec psql -h "$POSTGRES_PORT_5432_TCP_ADDR" -p "$POSTGRES_PORT_5432_TCP_PORT" -U postgres'

See the PostGIS documentation for more details on your options for creating and using a spatially-enabled database.

Known Issues / Errors

When You encouter errors due to PostGIS update OperationalError: could not access file "$libdir/postgis-X.X, run:

docker exec some-postgis update-postgis.sh

It will update to Your newest PostGIS. Update is idempotent, so it won't hurt when You run it more than once, You will get notification like:

Updating PostGIS extensions template_postgis to X.X.X
NOTICE:  version "X.X.X" of extension "postgis" is already installed

ALTER EXTENSION
Updating PostGIS extensions docker to X.X.X
NOTICE:  version "X.X.X" of extension "postgis" is already installed

ALTER EXTENSION

About

Docker image for PostGIS

https://registry.hub.docker.com/u/mdillon/postgis/

License:MIT License


Languages

Language:Shell 59.1%Language:Dockerfile 37.9%Language:Makefile 3.0%