@@ -76,16 +76,53 @@ docker logs geopython-workshop-jupyter
7676# look for URL+Token and Copy/Paste in browser
7777```
7878
79- ## Installation Failures
79+ ## Installation Issues
8080
81- Still installation failures or no Docker installed? With some limits you may follow most of the workshop via a remote "Binder" instance.
81+ Docker installed but problems installing/running the workshop? Below some tips:
8282
83- As a last resort and with some limits (e.g. no local geo-services, no data publication),
84- you may follow most of the workshop using a remote Docker instance within your browser via "Jupyter Binder". Click on the button below
85- to launch the Workshop Binder Instance. Be patient for the startup.
83+ ### Download Problems
84+
85+ Although ` curl ` may be on your system it may have problems with SSL (one user noted using OSGeo4W).
86+ In that case you can copy/paste the download URL in your browser and download from there.
87+
88+ ### File/Drive Sharing
89+
90+ The workshop setup involves Docker Volume Mounting.
91+ For Mac OS and Windows installs be sure to ** enable File/Drive Sharing** for the directory where you unzipped the workshop.
92+ Go to the ` Preferences/Settings | File Sharing... ` menu and make settings accordingly.
93+
94+ ### Running in VirtualBox
95+
96+ You may also run a VirtualBox VM with preferably Ubuntu, install Docker there and run the workshop. Even better if
97+ you use [ Vagrant] ( https://www.vagrantup.com ) to provision/manage your VM. You could even unpack the .zip file
98+ on your local machine and mount it within the VM, start the workshop there.
99+
100+ In any case, in order to access the services from your local machine, you need to do port mapping from
101+ ports within the VM to your local machine in order to access the workshop from your local browser.
102+ The following ports need to be mapped from the VirtualBox VM to your local system:
103+ ** 8888 (Jupyter)** , ** 5000 (pygeoapi)** and ** 8001 (pycsw)**
104+
105+ ### Cannot Access URL
106+
107+ The workshop should run on http://127.0.0.1:8888?token= <token > but in some cases this may not work.
108+ In that case you could also try http://0.0.0.0:8888?token= <token >.
109+
110+ ## No Docker Installed?
111+
112+ If you somehow were not able to install Docker:
113+ there is a Cloud version of the Jupyter-Notebook-part of the workshop via "Jupyter Binder".
114+
115+ With some limits (e.g. no local geo-services, no data publication),
116+ you may follow most of the workshop using a remote Docker instance within your
117+ browser via "Jupyter Binder". Click on the button below
118+ to launch the Workshop Binder Instance. Startup takes a while, be patient...
86119
87120[ ![ Binder] ( https://mybinder.org/badge_logo.svg )] ( https://mybinder.org/v2/gh/geopython/geopython-workshop/master?filepath=workshop%2Fjupyter%2Fcontent%2Fnotebooks%2F01-introduction.ipynb )
88121
122+ Additional notes for Binder session:
123+
124+ * session timeout is about 10 mins, if that happens, refreshing the page will not help, you need to start a new session using the button above
125+
89126## Support
90127
91128A [ Gitter] ( https://gitter.im/geopython/geopython-workshop ) channel exists for
0 commit comments