Troubleshooting
Where the logs are
Section titled “Where the logs are”- Service log:
~/.local/state/xtux/service.log. Game starts, the game bridge (tokens, licenses) and errors ofxtux-serviceend up here, also when you start games from the launcher. - Terminal:
xtux-cliprints progress and errors directly. - More detail:
XODUS_LOGsets the log filter, for exampleXODUS_LOG=debug xtux-cli run "...". Wine’s own output can be widened withWINEDEBUG.
When you report a problem, add the game, your distribution, GPU and driver, and the relevant part of the log. Remove tokens and personal data first.
Debug switches
Section titled “Debug switches”| Variable | Effect |
|---|---|
XTUX_DIRECT=1 |
Run the command inside xtux-cli instead of through xtux-service; output goes to the terminal |
XTUX_IDLE_TIMEOUT=<seconds> |
How long xtux-service waits idle before it exits (default 300, 0 keeps it running) |
XTUX_SERVICE=<path> |
Use this xtux-service binary instead of the one next to xtux-cli |
XTUX_SKIP_SMBIOS=1 |
Register the PC without the firmware information, see password prompts |
Common problems
Section titled “Common problems”A password dialog appears
Section titled “A password dialog appears”See Sign-in and password prompts: it is either your keychain or the one-time registration of the PC.
“cannot read the device license from the keychain”
Section titled ““cannot read the device license from the keychain””The keychain is locked or not running. Unlock KWallet or GNOME Keyring and try again. Make sure a Secret Service
provider runs in your session (gnome-keyring-daemon or kwalletd).
“… is neither a game folder nor an installed game”
Section titled ““… is neither a game folder nor an installed game””run did not find the name in your library. Check xtux-cli list, the library_dirs in the settings, and that the
Windows partition is mounted.
“… is installed more than once”
Section titled ““… is installed more than once””The same game is in two library folders. Start it by path, as the message shows.
No Wine binary
Section titled “No Wine binary”run needs the Wine binary, either as the second argument or as wine in the settings (launcher: Settings).
The game shows a black screen or no intro video
Section titled “The game shows a black screen or no intro video”Make sure the prefix was set up with xtux-cli prefix init and that you start the game with the Tux-Force Wine
build; it contains the video decoder setup and runtime the games need. Check the
compatibility list for known problems with the game.
The game cannot reach its online services
Section titled “The game cannot reach its online services”Run xtux-cli prefix init again: it adds the Microsoft root certificates games expect. Check the service log for
errors of the game bridge.
xtux-cli crashes with “illegal instruction”
Section titled “xtux-cli crashes with “illegal instruction””xTux uses the AES instructions of the CPU to decrypt game packages. CPUs older than about 2011 do not have them.