Skip to content

Commit 0be9047

Browse files
committed
#38 some more installation issue notes
1 parent ae20845 commit 0be9047

1 file changed

Lines changed: 16 additions & 4 deletions

File tree

web/docs/index.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,8 @@ In that case you can copy/paste the download URL in your browser and download fr
8888
### File/Drive Sharing
8989

9090
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.
91+
For Mac OS and Windows installs be sure to **enable File/Drive Sharing** within Docker Desktop
92+
for the directory where you unzipped the workshop.
9293
Go to the `Preferences/Settings | File Sharing...` menu and make settings accordingly.
9394

9495
### Running in VirtualBox
@@ -100,12 +101,23 @@ on your local machine and mount it within the VM, start the workshop there.
100101
In any case, in order to access the services from your local machine, you need to do port mapping from
101102
ports within the VM to your local machine in order to access the workshop from your local browser.
102103
The following ports need to be mapped from the VirtualBox VM to your local system:
103-
**8888 (Jupyter)**, **5000 (pygeoapi)** and **8001 (pycsw)**
104+
**8888 (Jupyter)**, **5000 (pygeoapi)** and **8001 (pycsw)** .
105+
106+
You will possibly need to enable firewall access for these ports within your VM. Do this as follows:
107+
108+
```
109+
sudo ufw allow 8888/tcp
110+
sudo ufw allow 5000/tcp
111+
sudo ufw allow 8001/tcp
112+
```
113+
114+
Within VirtualBox menu you can then map these ports to the same ports on your local system, so the workshop
115+
is accessed with your local browser via http://127.0.0.1:8888?token=..., http://127.0.0.1:5000 etc.
104116

105117
### Cannot Access URL
106118

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>.
119+
The workshop should run on http://127.0.0.1:8888?token="token" but in some cases this may not work.
120+
In that case you could also try http://0.0.0.0:8888?token="token".
109121

110122
## No Docker Installed?
111123

0 commit comments

Comments
 (0)