chbrandt/gispy repository overview

⁠GIS-Python tools

Docker images for GIS processing with Python.

All containers here extend the one provided by OSGeo with GDAL installed, osgeo/gdal⁠.

Images built from dockerfiles⁠ here defined are available in the DockerHub under chbrandt/gispy

• https://hub.docker.com/r/chbrandt/gispy⁠

Especifically, the following tags are associated to dockerfiles in here:

• gispy:gdal⁠

  • chbrandt/gispy:gdal-3.2.0
  • chbrandt/gispy:gdal
  • chbrandt/gispy:latest

• gispy:jupyterhub⁠

  • chbrandt/gispy:jupyterhub

⁠Basic container

The simplest container to run here goes:

% docker run -it --rm chbrandt/gispy:gdal

, and you should land in the container shell (-it). Exit (ctrl-d) and the container will be remove too (--rm)

To have some (geo) data in there, you can mount a volume (-v),

% docker run -it --rm --name gispy \
    -v $PWD:/mnt/data \
    chbrandt/gispy:gdal

, where current working directory ($PWD) is being mapped to container's /mnt/data.

⁠Jupyter container

In the following examples, localhost' port 8000 is being used to run the container running Jupyter ("gdal_jupyter").

To run the image using the default user user:123456,

% docker run -it --rm --name jupyterhub \
    -p 8000:8000 -v $PWD:/mnt/data \
    chbrandt/gispy:jupyterhub

To run the image using GitHub authentication,

% docker run -it --rm --name gispy_jupyterhub \
    -p 8000:8000 -v $PWD:/mnt/data \
    -e GITHUB_CLIENT_ID=<your-github-client-id> \
    -e GITHUB_CLIENT_SECRET=<your-github-client-secret> \
    chbrandt/gispy:jupyterhub