Skip to main content
Last updated on Nov 05, 2024 WSL environments are Linux shells installed on Windows machines. These can be very useful for testing your code on Linux environments, without having to use a separate machine. You can install Incredibuild Agents on WSL environments, however, Incredibuild Coordinators must be install on standard Linux machines. When installing in a WSL environment, some extra steps are required to ensure that communication between Incredibuild components is possible.

Supported Versions

  • WSL 2

How to Install Incredibuild on WSL

  1. Install WSL on your machine using a distribution certified by Incredibuild that is also supported by WSL.
  2. Install your Incredibuild Agent on the WSL using the standard installation procedure. Connect to an existing Incredibuild Coordinator on an standard Linux machine (not WSL).
  3. Create inbound and outbound firewall rules, and configure port forwarding as required. We have provided sample scripts to manage this below. When installing, if you are using our scripts run both the installation and the reboot batch files.
  4. Go to your firewall and verify that the new inbound and outbound rules specified in the batch file have been created.
  5. Run any build and verify that your helper agents are participating in the build. If the batch file was not configured correctly, the helper agents will be visible in your Coordinator, but they will not assist in builds.
  6. Whenever you reboot your WSL instance or host machine, you will need to restart the Incredibuild service, fetch the WSL internal IP, and initiate the port forwarding process for the corresponding ports. You can use our sample reboot batch file below to do this.

Configuring the Installation Batch File

This script will creates the inbound and outbound firewall rules. If you are not using the default ports, modify them in your batch file. You will only need to run this file once, during the installation process. Copy

Configuring the Reboot Batch File

This script turns on the Incredibuild service, fetches the WSL internal IP, and initiates the port forwarding process for the corresponding ports. It should be run once during installation, and every time you reboot your WSL instance or the host machine. Copy