Skip to content

Linux support

Jump to bottom
RealSupremium edited this page Sep 5, 2026 · 11 revisions

PlayStation VR2 Toolkit supports Linux using a new piece of software we have developed, called Ignition, which lets you run supported Windows SteamVR drivers on Linux, using Wine/Proton.

Caution

You should have some basic knowledge of how to use Linux. If you don't, you'll probably have a bad time trying to get everything to work. Using your favorite search engine or asking others for help is a good idea if you are stuck.

Wired Linux VR is also not guaranteed to be a good experience depending on your GPU and which architecture you use and what settings your distro applies. Any immutable distro is not recommended, but it is possible if you know what you're doing.

SteamVR on Linux also has some issues and missing features. You have been warned.

Missing or restricted features

The following features are not available or have limitations on Ignition:

  • SteamVR Room View (unsupported or unstable)
  • Official Sony PSVR2 Apps
  • Controller poll rate (can cause an unstable Bluetooth connection)

All other features of PSVR2TK or the PSVR2 driver should be functional.

Setting up Ignition

Prerequisites

You will need the following prerequisites installed:

Ignition currently is NOT in any package manager, so you must download the release from GitHub here.

Getting the prerequisites ready

  1. First, install Steam, where you will then get SteamVR, PlayStation VR2 App, and Proton Experimental.
  2. Get jq from your package manager of choice. This is for the Ignition setup shell script to create the config for you.
  3. For user apps like SteamVR, Ignition, PSVR2Updater, vr2jb, etc. to work, you will need to install xr-hardware. Do not get it from a package manager, as the left controller will not work. Run the following one-liner:
    • sudo wget -O /etc/udev/rules.d/70-xrhardware.rules "https://gitlab.freedesktop.org/monado/utilities/xr-hardware/-/raw/main/70-xrhardware.rules?ref_type=heads" && sudo udevadm control --reload-rules && sudo udevadm trigger
  4. Follow the instructions for installing SteamVRLinuxFixes on the main GitHub page. SteamVRLinuxFixes is required to fix what Valve hasn't bothered fixing.

Updating your PSVR2

Before using your PSVR2 on Linux, you will need to make sure you have a PC compatible firmware. v5.00 or greater will work. If not, see instructions on upgrading here. You will use PSVR2Updater to perform the upgrade, as the official app does not launch on Linux.

Using Ignition

  1. First, extract the contents of Ignition-Linux-Windows.zip to a folder like /opt/ignition/ or ~/ignition. The Ignition folder MUST be accessible through the Steam Linux Runtime container.
  2. Assuming your Steam folder is at ~/.steam/steam/ (if it is not, try finding it), run ./install_ignition.sh "$HOME/.steam/steam/steamapps/common/PlayStation VR2 App/SteamVR_Plug-In/" while in the folder you extracted Ignition to.
  3. Next, navigate to ~/.steam/steam/steamapps/common/PlayStation VR2 App/SteamVR_Plug-In/bin/linux64 and run driver_install.sh in the folder.
    • Double check that ~/.config/openvr/openvrpaths.vrpath has something like "/home/username/.steam/steam/steamapps/common/PlayStation VR2 App/SteamVR_Plug-In" in the external_drivers list. If openvrpaths.vrpath does not exist, you may need to run SteamVR once before using install_driver.sh.
  4. Now, you will install the experimental PSVR2Toolkit release
    • Renaming driver_playstation_vr2.dll to driver_playstation_vr2_orig.dll
    • Then extracting contents of PSVR2TK-win64-Ignition.zip into ~/.steam/steam/steamapps/common/PlayStation VR2 App/SteamVR_Plug-In/bin/win64
  5. You should be able to launch SteamVR and see the PSVR2 headset and Sense controller icons in green.
    • If not, check the logs in ~/.steam/steam/logs, specifically vrcompositor.txt and vrserver.txt for any errors.

Room Setup

To have position tracking, you will need to run PSVR2Toolkit.UnitySetup. Find the Linux release and run it.

Audio

To hear audio from the PSVR2 headset, make sure you set the GPU Audio Output Profile to HDMI 2. In some cases, it may be HDMI 6.

Configuring SteamVR for the best experience

In ~/.steam/steam/config/steamvr.vrsettings, you should edit it to add "enableLinuxVulkanAsync" : true and "useFacetRenderer" : true to the steamvr section. Big Valve does not want you to know this.

Your steamvr section should look like this:

   "steamvr" : {
      "enableHomeApp" : false,
      "enableLinuxVulkanAsync" : true,
      "haveStartedTutorialForNativeChaperoneDriver" : true,
      "lastVersionNotice" : "2.16.7",
      "overlayRenderQuality_2" : 3,
      "preferredRefreshRate" : 120,
      "showAdvancedSettings" : true,
      "showMirrorView" : false,
      "showPerfGraph" : true,
      "supersampleManualOverride" : true,
      "useFacetRenderer" : true
   }

Do not forget to put commas after each line except for the last one, or else the config will be wiped due to syntax errors.

Troubleshooting

This section covers some common issues when using Ignition and PSVR2Toolkit.

Installation

  • Make sure SteamVR, PSVR2 App and Proton Experimental are installed on the main OS Drive. This is where Ignition and PSVR2 Toolkit expect them.
    • To make sure Proton is detected by Ignition, you can also run ./proton run cmd in ~/.steam/steam/steamapps/common/PlayStation VR2 App/SteamVR_Plug-In/bin/linux64/ and see what the script outputs as well as if a command prompt window appears.
  • Try using the beta version of SteamVR.
  • Make sure to setup your play area using PSVR2Toolkit.UnitySetup to have 6DOF tracking and avoid SteamVR bugs when no play area is set.

Controllers not showing up in SteamVR

Make sure "Gamepad Support" is disabled in SteamVR's manage add-ons section. Also, double check xr-hardware is installed. Disconnecting and reconnecting the controllers can help.

Left controller not working

  • Make sure you followed the steps described above to install xr-hardware correctly. The package manager version is out-of-date.

SteamVR Error 497 (Failed to Connect to Window Manager)

This is typically caused by bugged Mesa driver builds (specifically Mesa 25.3.0–25.3.1). Check your installed Mesa version with:

vulkaninfo --summary

Some window managers or desktop environments may not support DRM leasing. Make sure you're using a version that does support DRM leasing.

Bad controller tracking

Due to a limitation in BlueZ, the polling rate for the controllers cannot be set properly to achieve the same tracking quality as on Windows. By default, the Linux kernel does not allow Bluetooth devices to enter "sniff mode" to reduce bandwidth. With both controllers running at the maximum poll rate, this causes instability. There is a community patch available. You will need to build it from source or wait for it to be upstreamed.

Other issues

If none of these issues above helped or match your problem, please join our Discord and ask in our support channels. When asking for help try to provide some information about your setup like:

  • Linux Distro and version (eg Linux Mint 22.3, Bazzite 44 or CachyOS)
  • Mesa driver version: vulkaninfo --summary
  • Do you have Proton Experimental installed on your main OS drive where you have Steam installed?
  • Any error logs in ~/.steam/steam/logs, specifically vrcompositor.txt and vrserver.txt
  • Screenshots, if applicable

Clone this wiki locally