Skip to content

Commit 2d221a9

Browse files
authored
Add the note to the index page plus minor grammar fixes (#102)
1 parent 5aea226 commit 2d221a9

2 files changed

Lines changed: 9 additions & 5 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ output visible via `docker logs --follow geopython-workshop-jupyter`.
4949

5050
### Notes
5151

52-
- There is an issue with MacOS Monterey where the port 5000 is already used and therefore conflicting to that one used by pygeoapi. If you are facing with 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 Preference->Sharing` of your MacOS (detailed description in this blog [post](https://progressstory.com/tech/port-5000-already-in-use-macos-monterey-issue/)).
52+
- 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](https://progressstory.com/tech/port-5000-already-in-use-macos-monterey-issue/)).
5353

5454
### Bugs and Issues
5555

web/docs/index.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,7 @@ Below are utility commands. Use when stopped to clean and update.
103103
./geopython-workshop-ctl.sh clean
104104

105105
```
106-
106+
107107
## Installation Issues
108108

109109
Docker installed but problems installing/running the workshop? Below some tips:
@@ -124,7 +124,7 @@ Go to the `Preferences/Settings | File Sharing...` menu and make settings accor
124124

125125
You may also run a VirtualBox VM with preferably Ubuntu, install Docker there and run the workshop. Even better if
126126
you use [Vagrant](https://www.vagrantup.com) to provision/manage your VM. You could even unpack the .zip file
127-
on your local machine and mount it within the VM, start the workshop there.
127+
on your local machine and mount it within the VM, start the workshop there.
128128

129129
In any case, in order to access the services from your local machine, you need to do port mapping from
130130
ports within the VM to your local machine in order to access the workshop from your local browser.
@@ -133,11 +133,11 @@ The following ports need to be mapped from the VirtualBox VM to your local syste
133133

134134
You will possibly need to enable firewall access for these ports within your VM. Do this as follows:
135135

136-
```
136+
```shell
137137
sudo ufw allow 8888/tcp
138138
sudo ufw allow 5000/tcp
139139
sudo ufw allow 8001/tcp
140-
```
140+
```
141141

142142
Within VirtualBox menu you can then map these ports to the same ports on your local system, so the workshop
143143
is accessed with your local browser via http://127.0.0.1:8888?token=..., http://127.0.0.1:5000 etc.
@@ -147,6 +147,10 @@ is accessed with your local browser via http://127.0.0.1:8888?token=..., http://
147147
The workshop should run on http://127.0.0.1:8888?token="token" but in some cases this may not work.
148148
In that case you could also try http://0.0.0.0:8888?token="token".
149149

150+
### MacOS Monterey issue
151+
152+
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](https://progressstory.com/tech/port-5000-already-in-use-macos-monterey-issue/)).
153+
150154
## No Docker Installed?
151155

152156
If you somehow were not able to install Docker:

0 commit comments

Comments
 (0)