Skip to content

Commit ae20845

Browse files
committed
#38 some more installation issue notes
1 parent 789c3b4 commit ae20845

1 file changed

Lines changed: 42 additions & 5 deletions

File tree

web/docs/index.md

Lines changed: 42 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -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

91128
A [Gitter](https://gitter.im/geopython/geopython-workshop) channel exists for

0 commit comments

Comments
 (0)