This page provides help to install requirements for
- Pip to install python packages
- Docker to run services
If you just want to run
d2s we recommend you to use pipx as it install the tool in an isolated environment. It can be compared to
Consider doing a
pip install --upgrade pipto update your pip installation.
pip3to make sure
pipxis installed with Python3, but feel free to use your own
pip3 if not installed.
- Open the PowerShell as administrator to install Chocolatey and its packages.
- Check and fix system restrictions:
- Install Chocolatey on PowerShell:
See the official Chocolatey documentation.
Chocolatey can also be installed using a non-administrative shell. See the documentation.
Open the PowerShell as administrator and use Chocolatey to install Python 3.8 and pip:
A reboot of your system is required to complete the installation.
Pip does not need to be run as administrator (only
Upgrade d2s to the latest release:
If you face issues where
cwl-runner is already installed, try to make sure it is properly uninstall from
If you are facing issue with
No module name pip found, it might be due to pip and pipx version issues. Be careful when installing
pipx as you want it to properly use
python3.6. Those commands will help you uninstalling
sudo groupadd dockercould be required before
usermodif the group has not been created.
Use the Docker installer for MacOS (
.dmg file) to install Docker and
You can change Docker settings by clicking on the Docker icon 🐳 in the top bar, then click Preferences...
/tmp should be shared by default. It is recommended to create the
d2s project folder in a subfolder of
Install the Docker Desktop for Windows (now also available for Windows Home)
Activate Virtualization: Virtualization and Hyper-V might need to be activated. Check in the
Task Manager , in tab
Performance if Virtualization is
Check the documentation to enable it.
Docker-desktop installation will propose to install virtualization automatically after the Docker installation, if they are not installed.
Note that Docker Hyper-V is not available for Windows 10 Home edition (you will need Pro or Enterprise edition)
You might need to access the BIOS to enable VT-x virtualization
docker-toolbox are sharing your
C:/Users volume. Docker will only be able to access folders and files in the
Shared Drives. So make sure you execute
d2s init somewhere in your users directories.
docker-desktopyou can change it in Docker config >
Shared Drives> Share Drive C
docker-toolboxyou need to change the settings of the Virtual Box
DNS issue: Docker build can't access the internet. E.g.: getting
wget: unable to resolve host address
If Docker can't access internet when building you might want to change the DNS (to use Google's one).
On Linux:nano /etc/resolv.conf> nameserver 18.104.22.168
On Windows: go to
Firewall issue on Windows: it is common to face a firewall when Docker tries to connect to the internet
- This could be due to local services: try deactivate your firewall and/or antivirus
- If you are running it on your office network you might face issues related to the office network firewall. Try at home and contact your IT department if needed.
Check the Docker guide
For more details on how to run Docker see the Docker guide.