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
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.
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
- 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
On Ubuntu the
root user can be switched to via
sudo su - specifying your
notes user password.
sudo su -
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 docker.io
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.
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 https://github.com/HCL-TECH-SOFTWARE/domino-container.git 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
This completes the setup for your Docker environment.
Contine with Quickstart to build and run your first container.
Microsoft WSL2 install documentation.