Lutris on SteamOS

Scope

Lutris organizes games, emulators, launchers, Wine builds, and community installation recipes. Its official SteamOS path is Desktop Mode and Discover.

Trust boundary

An installer script can download executables, create a prefix, select a runner, add registry or environment changes, and write shortcuts. Read the script source, destination URLs, and issue history; do not treat a one-click recipe as a sandbox.

Supported installation

Install net.lutris.Lutris from Discover. Before running a community installer, record its page, revision, files, runner, prefix destination, and required account. Prefer a small test library path with adequate space.

Verification

Record Lutris/Flatpak version, script revision, runner and umu choice, prefix, game build, GPU/driver, and launch log. Test Desktop Mode first, then create and verify a Steam shortcut separately.

Update

Update Lutris through Discover and runners through Lutris. Do not update the application, runner, script recipe, and game in one diagnostic step. Preserve the last working runner.

Uninstall

Remove the library entry only after confirming whether it deletes files. Uninstall the application separately from runners, prefixes, installers, game files, and saves; back up Lutris's library metadata if rebuilding.

Rollback

Restore the prior runner, environment, and launch arguments. Reuse the original prefix only after backup. If the Steam shortcut alone fails, recreate it without reinstalling the Lutris game.

Use Lutris for complex community recipes, multiple runner types, or launchers not covered by a focused client such as Heroic or Bottles. Prefer the narrowest tool that solves the task.

Frequently asked questions

Are Lutris installer scripts the same as application packages?
Are Lutris installer scripts the same as application packages?
No. They are recipes that can download components and configure runners, prefixes, files, and shortcuts. Review the exact script and sources before running it.
Should I install Lutris with setup.py on SteamOS?
Should I install Lutris with setup.py on SteamOS?
No. Lutris explicitly warns that setup.py does not install all integration cleanly and is difficult to uninstall; use Discover/Flatpak on SteamOS.

Sources

Version history

  • 2026-07-15: Phase 6 SteamOS install, script-trust, runner, and rollback review.