starefossen/pgrouting repository overview

⁠Docker pgRouting

The starefossen/pgrouting Image provides a Docker Image with Postgres, PostGIS, and pgRouting installed. This image is based on the postgres⁠ and mdillon/postgis⁠ Docker Images.

⁠Supported tags and respective Dockerfile links

The following Docker Image tags are supported.

⁠What is pgRouting

pgRouting extends the PostGIS / PostgreSQL geospatial database to provide geospatial routing functionality.

⁠How to use this image

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

$ docker run --name some-pgrouting \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -d starefossen/pgrouting

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-pgrouting:postgres --rm postgres \
  sh -c 'exec psql -h "$POSTGRES_PORT_5432_TCP_ADDR" -p "$POSTGRES_PORT_5432_TCP_PORT" -U postgres'

⁠Image Variants

The starefossen/pgrouting images come in two flavors, each designed for a specific use case.

starefossen/pgrouting:latest

This is the bleeding edge latest version of the image. You should use this under active development, but not for stable production usage.

starefossen/pgrouting:<version>

This is the locked down version of the image. If comes in two variants, major versions major+minor for Postgres, PostGIS, and pgRouting as the version tag.

⁠License

This Docker image is licensed under the MIT License⁠.

Software contained in this image is licensed under the following:

• PostgreSQL: PostgreSQL License⁠
• PostGIS: GNU GPL v2⁠
• pgRouting: GNU GPL v2⁠

⁠Supported Docker versions

This image is officially supported on Docker version 1.8.1.

Support for older versions (down to 1.0) is provided on a best-effort basis.

⁠User Feedback

⁠Documentation

• Postgres⁠
• PostGIS⁠
• pgRouting⁠

⁠Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue⁠.

⁠Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue⁠, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.