The workshop requires Docker and Docker Compose on your system

The Docker Images for this workshop are available on DockerHub. The name of the workshop Image is geopython/geopython-workshop[:latest]. Note that the Docker Images contain mainly all (Python) components/dependencies. The actual workshop content (data+notebooks) will be Docker-Volume-mounted.

You may always build a Docker Image from this repo yourself:

git clone https://github.com/geopython/geopython-workshop.git
cd geopython-workshop.git/workshop/jupyter
./build.sh

All services are started using a Docker Compose file.

cd workshop
# start workshop
./geopython-workshop-ctl.sh start
# display URL and open in default web browser
./geopython-workshop-ctl.sh url

# Browse to http://127.0.01:5000 for workshop pygeoapi service
# Browse to http://127.0.01:8001 for workshop pycsw service
# NB Possibly best if we add a frontend or use docs ("home") as entrypoint
./geopython-workshop-ctl.sh stop

NB Jupyter notebook needs a token. The token is displayed on startup:

http://127.0.0.1:8888/?token=<longtokenhexstring>.

As Docker Compose may run in background you can make logging output visible via docker logs --follow geopython-workshop-jupyter.

• There is an issue with MacOS Monterey where the port 5000 is already used and therefore conflicting with that one used by pygeoapi. If you are facing this error OSError: [Errno 48] Address already in use then your machine is affected. To overcome the issue you can disable the Airplay Receiver from System Preferences->Sharing of your MacOS (detailed description in this blog post).
• Docker must be managed by non-root users in linux. Please make sure to perform the following post-installation step.

All bugs, enhancements and issues are managed on GitHub.

https://gitter.im/geopython/geopython-workshop