pkorduan/postgis repository overview

⁠pkorduan/postgis

This image has been created to use in combination with kvwmap-server image.

The postgis image provides a Docker container running Postgres 13 with PostGIS 3⁠ installed. This image is based on the official postgres⁠ image.

This image ensures that the default database created by the parent postgres image will have the postgis and postgis_topology extensions installed. Unless -e POSTGRES_DATABASE 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 pgsql-server -e POSTGRES_PASSWORD=mysecretpassword -d pkorduan/postgis:13.1-3.1

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 --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.