Help

Find help with installing Nadare, signing in and starting games. If your problem is not listed, run doctor — it checks your system and prints the fix.

./Nadare-*.AppImage doctor

Flatpak: flatpak run io.github.frostlinuxdev.Nadare doctor. New to all this? Start here walks through the install step by step.

Logs: ~/.local/state/nadare/logs/, one folder per game and one file per run, rotated automatically, with secrets masked. Open them from the game page (Open logs).

Common problems

Double-clicking the AppImage does nothing

The file is not executable yet. Run chmod +x Nadare-*.AppImage, or open it once with Gear Lever, or on Mint right-click → Properties → Permissions → Allow executing file as program.

It starts and closes at once, or complains something is missing

Run ./Nadare-*.AppImage doctor in a terminal. It prints what is missing and the command that installs it. On Wayland the usual suspects are libwayland-cursor and libwayland-egl (plus xkeyboard-config).

My games show “Not installed” after an update

Update to 0.1.0b24 or newer and start it. It looks for each game in both folder layouts and shows a banner: “Nadare found … in a different folder than it remembers.” Press Review, pick the folder, and the game is back. Do not press Install first — that downloads the game again.

The first Play takes a long time, or downloads something

Normal, once: Nadare fetches its Proton runner and the Steam Runtime (a few hundred MB) the first time a game needs them. The game page says so while it happens. Later starts are quick.

Ubuntu asks for a permission before the game starts

Ubuntu 24.04 and newer block the game runtime until it is allowed once. Press Fix it on the game page, type your password, then Play now.

A game misbehaves, and it worked before

Try it with the Sandbox off (the switch on the game’s page). If that fixes it, please tell us which game: the Sandbox should not break anything.

Flatpak: it will not use my game folder

The Flatpak sees ~/Games, your other drives (/mnt, /media, /run/media) and its own folder. A library anywhere else is refused, and Nadare shows the one command that allows it. Or pick a folder in one of those places.

“FUSE” errors, or it will not start in a container

Add --appimage-extract-and-run to the command.

“Keyring unavailable” and Remember me is greyed out

Account logins go to the Secret Service only. Install a provider (gnome-keyring, KWallet) — Nadare never writes a login token in plaintext as a fallback. Without a keyring you log in again each session.

Arknights or Stella Sora freezes on the first frame (NVIDIA, Wayland)

A DXVK present-timing bug. Nadare sets DXVK_CONFIG="dxvk.enablePresentTiming = False" for every catalog game automatically. A game you added yourself under Wine / Proton game needs that under extra_env in its profile.

The game says it opened your browser, but no window appears

The portal lost your display. Check journalctl --user -b | grep "no DISPLAY", then run dbus-update-activation-environment --systemd WAYLAND_DISPLAY DISPLAY and systemctl --user restart xdg-desktop-portal.

A proxy is ignored

Proxies come from the standard HTTPS_PROXY / HTTP_PROXY variables; there is no separate proxy setting. A proxy Nadare cannot use is refused rather than silently bypassed.

Chaos Zero Nightmare: the login window is blank or will not take input

WebView2 is missing from the prefix. Delete ~/.cache/nadare/czn/MicrosoftEdgeWebView2RuntimeInstallerX64.exe and retry; the prefix must be writable.

Chaos Zero Nightmare exit codes

ExitMeaningFix
2 Cannot reach the update server Network, DNS or proxy problem. Retry.
3 Login expired Log in again and scan the QR code.
6 No connection / handshake changed Try another runner, or update Nadare.
7 Handshake rejected The session was retired. Log in again; one client per account.
8 Already running in this profile Stop the running game first.
9 A runner download failed its checksum Retry Play once. If the checksum error returns, use Report a problem on the game’s page and include the error text so we can identify the affected runner.

Where your data lives

Config and profiles~/.config/nadare/
Games, runners, data~/.local/share/nadare/
Logs~/.local/state/nadare/
Cache~/.cache/nadare/
Account loginsyour keyring (nadare-launcher entries) — never a file
Shortcuts~/Desktop/*.desktop, Steam shortcuts.vdf if you asked for them

Flatpak: the same folders live under ~/.var/app/io.github.frostlinuxdev.Nadare/ — ~/.var/app/io.github.frostlinuxdev.Nadare/config/nadare/, …/data/nadare/, ~/.var/app/io.github.frostlinuxdev.Nadare/.local/state/nadare/ (logs) and …/cache/nadare/.

The full removal list, including keyring entries, is in Troubleshooting → Uninstall.

Report a bug

One problem per issue, and please include:

  • the Nadare version and how you installed it (AppImage, Flatpak, source);
  • distro, kernel, GPU and driver, desktop and whether it is Wayland or X11;
  • the log from Open logs — it is already masked — and the output of doctor;
  • what you expected and what happened, in one sentence each.