Run fault on a Microsoft Windows host

This guide will show you how to run fault on a Microsoft Windows host.

What You'll Achieve

You will learn how to run fault from a PowerShell command line or via the Windows Subsystem for Linux.

Run fault via Windows PowerShell

• Download fault for Windows

  Download the latest Windows release of fault from the releases page.

• Rename the binary

  Once downloaded, rename the executable to fault.exe

• Add the directory to the Path

  You may additionnaly update the Path so that fault is found.

  $env:Path += ';C:\directoy\where\fault\lives' 
  

Run fault via Windows Subsystem for Linux (WSL)

• Install a Ubuntu release

  Another approach to run from Windows is to benefit from the Windows Substem for Linux, which exposes Windows lower level resources in a way that allows Linux to run from them directly.

  wsl --install -d Ubuntu-24.04
  

  This will install a base Ubuntu distribution. It will ask you for a username and password along the way. Finally, it will log you in to that user.

• Configure the environment

  Install the jq command:

  sudo apt install -y jq
  

  Then, create the target directory where fault will be installed:

  mkdir -p .local/bin
  

  Add the following to your .bashrc file:

  export PATH=$PATH:$HOME/.local/bin
  

• Install fault

  Install fault using our installer script:

  curl -sSL https://fault-project.com/get | bash