Django-raster requires Django >= 1.9 configured with a PostGIS backend and the GDAL library. The use of Celery is highly recommended (see below).

The package is available on PyPI, you can install it with:

pip install django-raster

To integrate the package into Django, add raster to your INSTALLED_APPS setting like this:


Django-raster has its own url structure (to serve raster data through a TMS endpoint for instance). To activate those urls, add the raster urls to your main urlconf:

urlpatterns = [
    url(r'^raster/', include('raster.urls')),

Finally, migrate your database to create the tables required by django-raster:

python migrate

Distributed Task Management

Django-raster works best with Celery, a distributed task queue manager. Parsing raster files is a process that will time out most of the time if done through regular http requests. If Celery is installed, several long running tasks will be executed asynchronously in django-raster.

If you have Celery configured for your project, add the following to your project’s settings to tell django-raster to use it: