IDEasy Installation on Ubuntu in WSL2 (Windows Subsystem for Linux)

Table of Contents

Preparation

WSL for Windows can be installed through the Windows terminal (PowerShell, Git Bash, or CMD) using the following command:

wsl --install

Download Ubuntu from the Microsoft Store: Microsoft Store

Open an Ubuntu shell on your system. Ideally you do this via Windows Terminal or by typing Ubuntu in the Windows start menu.

Figure 1. Opening Ubuntu from Windows Start Menu

All the following steps and commands need to happen inside this Ubuntu terminal.

Figure 2. Ubuntu Terminal

Ensure Git is installed on your system. Check by opening Ubuntu via Windows Terminal or directly from the Windows Start menu and running:

git --version

If Git is not installed, use the following command to install git:

sudo apt install git

Refer to the detailed setup guide: Setup Instructions. So inside your Ubuntu shell install IDEasy via the following steps:

Copy the Maven link for the latest IDEasy release for Linux.
Download the file using wget:
```
wget «link-to-repo»
```
Verify the download with the ls command; the file should appear if downloaded correctly.
```
ls
```
Figure 3. Download and verify files with wget and ls (with an example of 2025.11.00 release)
Create a new directory IDEasy and extract the downloaded file:
```
mkdir IDEasy
tar xzf «downloaded-file-name» -C IDEasy
```
This extracts the contents into the IDEasy folder.
Run the setup script inside the IDEasy folder:
```
./IDEasy/setup
```
Follow the instructions in the terminal.
After installation, reboot the system:
```
sudo reboot
```

IDEasy is now installed on your Ubuntu system. A new directory called projects will be automatically created.

To set up the development environment, simply follow the development setup.