Using Docker is more difficult than using our virtual machine. You should first try using the virtual machine and only use Docker if the VM is not usable or you are already familiar with Docker.

If you encounter problems you can always ask questions on our Discord.

Installing Docker

Windows/macOS:

• Install Docker Desktop: https://www.docker.com/products/docker-desktop/

Linux:

• Install Docker using your package manager (apt, pacman, etc…)

Download Dockerfile & entrypoint.sh

espws24docker.zip

Unzip and move the directory to a location where you want to store your work for ESP (you can also rename the directory).

Example:

8192 B 📁 Documents
8192 B └─ 📁 esp_repos
4096 B    ├─ 📦 entrypoint.sh
4096 B    └─ 📄 Dockerfile

<aside> ⚠️

Storing your ESP repositories in a directory synchronised with a cloud provider (OneDrive, Dropbox, iCloud, …) is known to cause issues.

</aside>

Building & Starting for the first time

Start Docker Desktop/Docker.

Open a terminal in the previously downloaded directory.

On Windows: Shift+Right-Click → Open PowerShell

On macOS:

• Start Terminal
• Type cd (note the space at the end)