Windows Subsystem for Linux (WSL)
Windows Subsystem for Linux (WSL) is a compatibility layer developed by Microsoft that allows you to run a full Linux environment directly inside Windows — without needing a separate virtual machine or dual-boot setup.
For Cordatus, WSL is essential because the Cordatus Client is built to run in a Linux environment. By installing WSL on Windows, you create the required Linux environment (such as Ubuntu) where Cordatus can be installed and executed just like on a native Linux system.
If you plan to use Cordatus directly on a Linux system (e.g., Ubuntu) instead of Windows, you can skip this page and continue with the standard Linux installation instructions.
Installing and Using WSL
The easiest way to install WSL (Windows Subsystem for Linux) on your Windows device is by using a single command.
-
Open PowerShell as Administrator
- Click on the Start Menu, type PowerShell,
- Right-click on Windows PowerShell and choose Run as administrator.
-
Run the installation command
- In the PowerShell window, enter the following command:
wsl --install
-
Restart your computer
-
After restart, install Ubuntu OS with:
wsl --install Ubuntu
- Run WSL anytime After installation and restart, you can start WSL at any time by simply running the following command in either PowerShell or Command Prompt:
wsl
-
Exit WSL When you are done using WSL and want to return to Windows, simply type:
exit
When you first launch WSL using the wsl command, the session may start in a system directory (e.g., /mnt/c/Windows/System32) instead of your Linux home folder.
To switch to your home directory, run:
cd ~
Continuing with Cordatus Installation
After WSL has been successfully installed and your Ubuntu environment is ready, the installation of Cordatus continues exactly the same way as if you were setting it up on a regular Ubuntu Server.
From this point, simply follow the instructions in the next sections of this documentation as if you were installing Cordatus on Ubuntu Server.