Microsoft offers WSL2 a very interesting Linux integration platform, which is very convenient and flexible for local build and run-time environments. It can be used as build and run-time environmen for Domino on Docker.

The most flexible setup is to run one of the standard Linux distributions and install a Docker Linux host on the WSL2 instance. WSL2 is also used in current Docker Desktop installations. Important for a build environment is any Docker or Podman installation with Bash support.


Ensure you run at least

  • Windows 10 version 2004 or higher
  • Windows 11
  • Windows 2022

Install WSL2

Today WSL2 should be the default for each new installation. In case you are running the older WSL version, you have to switch to WSL2. Refer to details in the reference link below.

wsl --install

Install Linux Distribution

Once WSL2 is installed, WSL can list all available Linux distributions.

For SUSE Linux installations it is recommended to install the SUSE Leap 15.3 version directly from the Microsoft online app store. The versions listed in WSL are outdated.

List available images

wsl --list --online

Install Ubuntu 20.04 LTS

WSL offers automatic installations of selected distributions:

wsl --install -d Ubuntu-20.04

Once Ubuntu ist installed, it can be launched in multiple ways:

  • Desktop/taskbar icon
  • wsl command line
  • Software like MobaXterm with WSL integration

Create a new user

When the container is launched for the first time, it asks to create a new user. For a Domino on Docker environment the best first user is notes.

On Ubuntu the root user can be switched to via sudo su - specifying your notes user password.

sudo su -

Update Ubuntu

The installed WSL Linux instance is not up to date after installtion.

apt update
apt uprade

Install Docker Server

Once updated the repository contains the Docker server. Install the server using the following command.

apt install

Linux distributions running on WSL don’t provide systemd by default.
Therfore the Docker daemon is not started automatically. The Domino Container script provides an option to start/stop the Docker server.

Install JQ

JQ is the standard tool for working with JSON files.
The domino_container scripts leverage JQ, which is included in all major distributions including Ubuntu.

apt install jq

Clone Docker Container Project

mkdir -p /local/github
cd /local/github
git clone 
cd domino-container

Install Nash!Com Domino Container Script


Start the Docker server

Once installed the domino_container script can start and stop the Docker server for you.

domino_container docker start

Check the Docker Client and Server Version

docker version

Next Steps

This completes the setup for your Docker environment.

Contine with Quickstart to build and run your first container.


Microsoft WSL2 install documentation.