gboeing/osmnx repository overview

⁠OSMnx Docker image

⁠Overview

OSMnx⁠ is a Python package to easily download, model, analyze, and visualize street networks and other geospatial features from OpenStreetMap. Use this image to run a lightweight container with JupyterLab, OSMnx, and the rest of the Python geospatial data science stack.

Citation info: Boeing, G. (2025). Modeling and Analyzing Urban Networks and Amenities with OSMnx⁠. Geographical Analysis, published online ahead of print. doi:10.1111/gean.70009

More information:

• Documentation⁠
• Examples gallery⁠
• GitHub repo⁠
• Journal article/citation⁠

⁠Usage

Download and install Docker Desktop⁠, then open its settings and verify your local drives are shared.

⁠Run the docker container

On Windows open a command prompt, change directory to location of notebook file, and run:

docker run --rm -it -p 8888:8888 -v "%cd%":/home/jovyan/work gboeing/osmnx:latest

On Mac/Linux open a terminal window, change directory to location of notebook file, and run:

docker run --rm -it -p 8888:8888 -v "$PWD":/home/jovyan/work gboeing/osmnx:latest

⁠Run a Jupyter notebook

Once the container is running as described above, open your computer's web browser and visit http://localhost:8888⁠.

⁠Run bash in this container

On Windows:

docker run --rm -it -v "%cd%":/home/jovyan/work gboeing/osmnx:latest /bin/bash

On Mac/Linux:

docker run --rm -it -v "$PWD":/home/jovyan/work gboeing/osmnx:latest /bin/bash