Skip to content

Instantly share code, notes, and snippets.

@Spywar3
Created March 4, 2026 09:28
Show Gist options
  • Select an option

  • Save Spywar3/2307482b95a0dfeea54917ead075431c to your computer and use it in GitHub Desktop.

Select an option

Save Spywar3/2307482b95a0dfeea54917ead075431c to your computer and use it in GitHub Desktop.
Installing Zwift on Linux using Steam.

Installing Zwift on Linux using Steam.

This describes the process on how to install Zwift on Linux using Steam to manage the game.

It has been verified with the following software versions:

  • Linux Kernel: 6.19.2-2
  • Steam Beta Branch: Stable Client
  • Steam Version: 1769025840
  • Steam Linux Runtime: proton-cachyos-10.0-20260207

Step 1) Download zwift.

Visit the following URL to download Zwift: https://www.zwift.com/download

Step 2) Launch the Zwift installer using Steam.

These steps will result in the creation of a Steam prefix to use.

  • Launch Steam.
  • Select Games Tab.
  • Select Add a Non-Steam Game to My Library.
  • Select Browse and locate the ZwiftSetup.exe that you downloaded.
  • Select Start on ur steam libary. This should fail to install.

Step 3) Run protontricks to get the PREFIXID.

This step will return the Wine Prefix ID needed. Replace PREFIXID and USER with the returned prefix ID and current linux username in the following steps.

protontricks -s zwift

Expected Output:

Found the following games:
Non-Steam shortcut: ZwiftSetup.exe (PREFIXID)

Step 4) Install the required libaries.

using protontricks, install the following libraries that are required to run Zwift.

WINEDEBUG=-all protontricks --no-background-wineserver PREFIXID -q dotnet20 dotnet40 dotnet48 corefonts

Step 5) Update the Wine prefix to win 7.

Perform the following command to update the Wine prefix to use Windows 7 version.

protontricks PREFIXID settings win7

Step 6) Launch the ZwiftLauncher.exe

This step should launch the Zwift installer, and then start the download and installation of Zwift. Once installed it will then launch the game.

protontricks-launch --appid PREFIXID "/home/USER/.local/share/Steam/steamapps/compatdata/PREFIXID/pfx/drive_c/Program Files (x86)/Zwift/ZwiftLauncher.exe"

Step 7) Update steam to now point to the ZwiftLauncher.exe

  • Right click on the ZwiftSetup.exe that you had added to your library and select properties.
  • In the UI, update the Target to the ZwiftLauncher.exe launcher location.
  "/home/USER/.local/share/Steam/steamapps/compatdata/PREFIXID/pfx/drive_c/Program Files (x86)/Zwift/ZwiftLauncher.exe"
  • In the UI, update the Start In location to the folder the ZwiftLauncher.exe is installed in.
  "/home/USER/.local/share/Steam/steamapps/compatdata/PREFIXID/pfx/drive_c/Program Files (x86)/Zwift/

If all steps completed successfully, you should be able to launch Zwift via steam.

Ride On!

@afrothundaaaa

Copy link
Copy Markdown

LEGEND I have been battling to figure out what was wrong with what i was doing, turns out proton was the culprit! Installed proton-cachyos-slr and that was the ticket!

Thank you so much!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment