heroku-geo-buildpack

by heroku

GitHub Readme.md

Heroku Buildpack: Geo

Heroku Buildpack Geo is a Heroku buildpack that installs the Geo/GIS libraries GDAL, GEOS and PROJ

It can be used to get GeoDjango or RGeo running on Heroku.

Usage

This buildpack is designed to be used in combination with other buildpacks by using Heroku's multiple buildpack support.

Ensure that Heroku Buildpack Geo is the first buildpack on your list of buildpacks:

$ heroku buildpacks
=== Buildpack URLs
1. https://github.com/heroku/heroku-geo-buildpack.git
2. heroku/python

Default Versions

The buildpack will install the following versions by default for new apps:

  • GDAL: 3.9.0
  • GEOS: 3.12.1
  • PROJ: 9.4.0

Note: Existing apps that don't specify an explicit version will continue to use the version used by the last successful build (unless the build cache is cleared).

You can change the version of each library that will be installed by setting the GDAL_VERSION, GEOS_VERSION or PROJ_VERSION config variables.

Available Versions

  • GDAL:
    • 2.4.0 (Heroku-20 only)
    • 2.4.2 (Heroku-20 only)
    • 3.5.0 (Heroku-20 and Heroku-22 only)
    • 3.6.4
    • 3.7.3
    • 3.8.5
    • 3.9.0
  • GEOS:
    • 3.7.2 (Heroku-20 and Heroku-22 only)
    • 3.10.2 (Heroku-20 and Heroku-22 only)
    • 3.10.6
    • 3.11.3
    • 3.12.1
  • PROJ:
    • 5.2.0 (Heroku-20 and Heroku-22 only)
    • 8.2.1 (Heroku-20 and Heroku-22 only)
    • 9.4.0

Migrating from heroku/python GEO support

If you were previously using the undocumented BUILD_WITH_GEO_LIBRARIES functionality of the official Heroku Python Buildpack here are instructions for changing to this buildpack:

  1. You have to completely remove the BUILD_WITH_GEO_LIBRARIES config variable like so - heroku config:unset BUILD_WITH_GEO_LIBRARIES
  2. You should consider flushing your applications build cache by following these instructions - https://help.heroku.com/18PI5RSY/how-do-i-clear-the-build-cache