Skip to content

Troubleshooting

Where Are The Logs?

By default, vrOS writes logs to a logs/ folder next to the installed executables (for Steam installs, that’s inside the vrOS install directory).

  • Main logs: <install>/logs/
  • Archived logs: <install>/logs/archive/

You can override the log directory with VROS_LOG_DIR.

vrOS Doesn’t Start

  1. Start SteamVR first.
  2. Launch vrOS from Steam.
  3. Check for the vrOS Director tray icon.
  4. If the tray icon is present, open Desktop Control Center from the tray.
  5. If nothing appears, check <install>/logs/error_*.log for the failure.

vrOS Dashboard Doesn’t Appear In SteamVR

  1. Open the Desktop Control Center.
  2. Check the Services/Overlays view for vros-catnet-dashboard and start it if it isn’t running.
  3. Re-open the SteamVR dashboard and look for vrOS Dashboard again.

Desktop Control Center Won’t Open

The tray action tries to restore an existing window titled vrOS Desktop. If it can’t find one, it spawns vros-catnet-desktop.exe.

  • Make sure vros-catnet-desktop.exe exists in the install directory.
  • Check logs for errors spawning the process.

Extensions Don’t Show Up

  1. Verify your folder structure includes extension.toml.
  2. Put the extension under <install>/extensions/<id>/extension.toml (recommended).
  3. If using VROS_EXTENSIONS_DIR, confirm you used the correct separator (; on Windows).

Graphics Debug Flags (Advanced)

The launcher supports a few debugging flags:

  • --d3d12-debug (enable D3D12 debug layer)
  • --d3d12-dred (enable DRED crash breadcrumbs)

These set environment variables like VROS_ENABLE_D3D12_DEBUG=1 before launching the runtime.