🌍 Here Be Dragons 🐲

A helpful Docker image for bleeding-edge spatial data analysis in Python.

Tricky dependencies are built from source so you can run the latest geoprocessing libraries that depend on Python, Arrow, GDAL, GEOS, and PROJ. See versions.toml for the list of packages built from source.

The Python package manager uv is pre-installed and is the recommended way to install additional packages.

Getting Started

You will need to install Docker.

On Windows, running Docker Desktop with Windows Subsystem for Linux (WSL) is recommended.

🐍 Latest

This Docker image is the stable version intended for production work with common geospatial libraries in the latest version of Python. The image is built on top of the most recent Ubuntu Long-Term Support release (ubuntu:latest).

To pull and start the container in your terminal:

docker run -it --name here-be-dragons-latest ghcr.io/corbel-spatial/here-be-dragons:latest

After the image downloads and opens a terminal you can see which packages are already installed by running:

uv pip list

geopandas and common dependencies are pre-installed, which you can check with:

python -c "import geopandas; geopandas.show_versions()"

To install additional packages use uv pip install --system, for example:

uv pip install --system geojson duckdb sedonadb

To update and restart the stopped container:

docker pull ghcr.io/corbel-spatial/here-be-dragons:latest
docker start here-be-dragons-latest
docker attach here-be-dragons-latest

🔥 Next

This Docker image is the experimental version intended for testing the latest pre-release version of Python against Arrow, GDAL, GEOS, and PROJ. Failing builds might indicate that issues are on the horizon. The image is built on top of the most recent Ubuntu release (ubuntu:rolling).

docker run -it --name here-be-dragons-next ghcr.io/corbel-spatial/here-be-dragons:next

📑 References

Project	Source	Downstream Packages
Arrow	https://github.com/apache/arrow	geoarrow-pyarrow
GDAL	https://github.com/OSGeo/gdal	Python bindings
GEOS	https://github.com/libgeos/geos	Shapely
PROJ	https://github.com/OSGeo/PROJ	Pyproj
Python (release schedule)	https://github.com/python/cpython	uv, Pixi
Ubuntu	https://hub.docker.com/_/ubuntu	n/a