Main Content

Downloading PX4 Source Code in Windows Subsystem for Linux (WSL2)


This section explains the task to be completed as part of the step—Download PX4 Source Code—of the Hardware Setup process (using the Hardware Setup screens).

UAV Toolbox Support Package for PX4® Autopilots requires PX4 Autopilot Firmware v1.14.

Download PX4 Source Code from GitHub

To download the PX4 source code (PX4 Autopilot Firmware v1.14) on a Windows® Subsystem for Linux:

  1. Launch the WSL2 shell.

  2. Navigate to the home directory by executing the cd ~.


    Cloning the firmware in WSL2 home directory is crucial. If you clone it outside of the WSL file system, then you will encounter slow execution issues and access right / permission errors.


    Ensure that your PC is connected to an active internet connection before proceeding with the next step.

  3. Download the PX4 source code using git.

    git clone --recursive

    The download may take several minutes to complete (depends on the internet speed).

  4. After the firmware is cloned, run the below commands one by one in WSL2.

    1. cd PX4-Autopilot

    2. git checkout v1.14.0 -f

    3. git submodule update --init --recursive

    After you complete this step, go back to the Hardware Setup screen again and continue with the next steps.