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.
Requirements
Section titled “Requirements”- A 64-bit Linux distribution
libfuse2for 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
Installation
Section titled “Installation”Claudio is distributed as an AppImage. Download Claudio-<version>-linux-x86_64.AppImage from the GitHub releases page.
-
Make it executable:
Terminal window chmod +x Claudio-*.AppImage -
Run it:
Terminal window ./Claudio-*.AppImage
First start
Section titled “First start”-
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.
-
Open Settings → Downloads and choose where games should be downloaded and installed. You can leave both empty to use the defaults.
-
Open a game in your library and press Install.
Running Windows games
Section titled “Running Windows games”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’scompatibilitytools.dand 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.
Shortcuts
Section titled “Shortcuts”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
Updating
Section titled “Updating”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.
Next steps
Section titled “Next steps”- Web UI vs Desktop App — what each client can do
- Library Structure — how to organize games on the server