Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/starefossen/docker-pgrouting
:whale: Docker Image for pgRouting with PostGIS and official Postgres Docker Image
https://github.com/starefossen/docker-pgrouting
docker docker-image pgrouting postgis postgres
Last synced: 9 days ago
JSON representation
:whale: Docker Image for pgRouting with PostGIS and official Postgres Docker Image
- Host: GitHub
- URL: https://github.com/starefossen/docker-pgrouting
- Owner: Starefossen
- License: mit
- Created: 2015-02-17T22:10:29.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-06-18T10:29:55.000Z (over 5 years ago)
- Last Synced: 2024-10-14T08:34:38.866Z (23 days ago)
- Topics: docker, docker-image, pgrouting, postgis, postgres
- Language: Shell
- Homepage: https://registry.hub.docker.com/u/starefossen/pgrouting/
- Size: 2.27 MB
- Stars: 33
- Watchers: 8
- Forks: 19
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker pgRouting
The `starefossen/pgrouting` Image provides a Docker Image with `Postgres`,
`PostGIS`, and `pgRouting` installed. This image is based on the
[postgres](https://github.com/docker-library/postgres) and
[mdillon/postgis](https://github.com/md5/docker-postgis) Docker Images.
## Supported tags and respective `Dockerfile` links
The following Docker Image tags are supported.
| Tag | Postgres | PostGIS | pgRouting |
|---------------|----------|---------|-----------|
| [`latest` (Dockerfile)](https://github.com/Starefossen/docker-pgrouting/blob/master/10.1-2.4-2.5/Dockerfile) | latest | latest | latest |
| [`9-2-2` (Dockerfile)](https://github.com/Starefossen/docker-pgrouting/blob/master/9.6-2.3-2.3/Dockerfile) | 9.6 | 2.x | 2.x |
| [`9.4-2.1-2.1` (Dockerfile)](https://github.com/Starefossen/docker-pgrouting/blob/master/9.4-2.1-2.1/Dockerfile) | 9.4.x | 2.1.x | 2.1.x |
| [`9.4-2.1-2.0` (Dockerfile)](https://github.com/Starefossen/docker-pgrouting/blob/master/9.4-2.1-2.0/Dockerfile) | 9.4.x | 2.1.x | 2.0.x |
| [`9.6-2.3-2.3` (Dockerfile)](https://github.com/Starefossen/docker-pgrouting/blob/master/9.6-2.3-2.3/Dockerfile) | 9.6.x | 2.3.x | 2.3.x |
| [`10.1-2.4-2.5` (Dockerfile)](https://github.com/Starefossen/docker-pgrouting/blob/master/10.1-2.4-2.5/Dockerfile) | 10.1.x | 2.4.x | 2.5.x |
## 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:
```bash
$ 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](https://registry.hub.docker.com/_/postgres/).
Once you have started a database container, you can then connect to the
database as follows:
```bash
$ 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:`
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](https://github.com/Starefossen/docker-pgrouting/blob/master/LICENSE).
Software contained in this image is licensed under the following:
* PostgreSQL: [PostgreSQL License](http://www.postgresql.org/about/licence/)
* PostGIS: [GNU GPL v2](https://github.com/postgis/postgis/blob/svn-trunk/COPYING)
* pgRouting: [GNU GPL v2](https://github.com/pgRouting/pgrouting/blob/master/COPYING)
## 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](http://www.postgresql.org)
* [PostGIS](http://postgis.net)
* [pgRouting](http://pgrouting.org)
### Issues
If you have any problems with or questions about this image, please contact us
through a [GitHub issue](https://github.com/Starefossen/docker-pgrouting/issues).
### 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](https://github.com/Starefossen/docker-pgrouting/issues), 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.