Skip to content

Installing on Linux

The Claudio desktop app lets you install and launch the games on your server directly from your Linux machine. Windows games are run through umu-launcher and Proton, so no manual Wine setup is needed.

  • A 64-bit Linux distribution
  • libfuse2 for running AppImages (or use --appimage-extract-and-run, see below)
  • A running Claudio server that you can reach from your machine
  • Free disk space for downloads and installed games

Claudio is distributed as an AppImage. Download Claudio-<version>-linux-x86_64.AppImage from the GitHub releases page.

  1. Make it executable:

    Terminal window
    chmod +x Claudio-*.AppImage
  2. Run it:

    Terminal window
    ./Claudio-*.AppImage
  1. Enter the address of your server, for example https://claudio.example.com, and continue.

    If your server sits behind a proxy that needs extra request headers, add them under Custom headers.

  2. Open Settings → Downloads and choose where games should be downloaded and installed. You can leave both empty to use the defaults.

  3. Open a game in your library and press Install.

Windows games run through umu-launcher, which Claudio downloads and manages for you. Each game gets its own Wine prefix.

  • Proton version — choose an installed build, or leave it on UMU-Latest. You can set a default under Settings → Downloads and override it per game in the game settings. Builds in Steam’s compatibilitytools.d and umu’s compatibility tools folders are detected automatically.
  • Game ID — the umu database ID used to apply game-specific fixes. Leave empty for umu-default.
  • Launch parameters — optional arguments passed to the game executable.

When installing a game you can create launchers for it:

  • Desktop — a shortcut on your desktop
  • App menu — an entry in your application launcher
  • Steam — a non-Steam game shortcut, handy for Big Picture and Steam Deck

The app checks for updates in the background and shows a notice when a new version is ready. You can also replace the AppImage with a newer one from the releases page.