Skip to content

Commit f41e42d

Browse files
committed
add additional notes for Windows installations
1 parent 82b33db commit f41e42d

File tree

1 file changed

+4
-3
lines changed

1 file changed

+4
-3
lines changed

workshop/content/docs/setup.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ In this workshop we use the following materials:
1010
1. **Exercises** - download the [latest zip file](https://github.com/geopython/diving-into-pygeoapi/archive/refs/heads/main.zip), unzip, find exercises in `workshop/exercises` [^1]
1111
1. **Docker** - all examples/exercises are run in a `Docker container` in `workshop/exercises`
1212

13-
[^1]: alternatively, you can fork/clone the GitHub repository of this workshop directly from https://github.com/geopython/diving-into-pygeoapi.
13+
[^1]: Alternatively, you can fork/clone the GitHub repository of this workshop directly from <https://github.com/geopython/diving-into-pygeoapi>.
1414

1515
## Text editor
1616

@@ -67,15 +67,16 @@ Docker installation has greatly progressed over the years. This is the only part
6767
which is dependent on the system/OS you are running (e.g. Windows, Mac or Linux). For each
6868
system the Docker website provides detailed installation instructions. Please follow these consistently.
6969

70-
For many platforms a product called `Docker Desktop` is available, which includes the main Docker components:
70+
For many platforms a product called [Docker Desktop](https://docs.docker.com/desktop) is available, which includes the main Docker components:
7171

7272
* Windows [installation](https://docs.Docker.com/desktop/install/windows-install)
7373
* Mac [installation](https://docs.Docker.com/desktop/install/mac-install)
7474
* Linux [installation](https://docs.Docker.com/desktop/install/linux-install)
7575

7676
Some notes:
7777

78-
* On Windows we recommend using the [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl) (WSL) as it also provides a powerful (Bash) command line and has optimal integration with Docker
78+
* On Windows we recommend using the [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl) (WSL) as it also provides a powerful (Bash) command line and has optimal integration with Docker. Before installing Docker Desktop, install WSL by opening Microsoft PowerShell (run as administrator) and type `wsl --install`.
79+
* **installing WSL requires administrator privileges on your system**
7980
* On Mac, if you are using [Homebrew](https://brew.sh), consider (as the author has) using the [brew Docker formula](https://formulae.brew.sh/formula/Docker)
8081
* On Mac OSX Monterey and later, there may be an issue with local port 5000 already in use, therefore conflicting with the default one used by the pygeoapi container. If you see this error `OSError: [Errno 48] Address already in use`, you need to disable the *Airplay Receiver*. Go to `System Settings | Sharing` or like in Sonoma type 'airplay' in the search box. See image below for Mac OSX Sonoma. Also a detailed description in [this blog post](https://progressstory.com/tech/port-5000-already-in-use-macos-monterey-issue/).
8182
![MacBook settings](assets/images/macosx-airplay-disable.png)

0 commit comments

Comments
 (0)