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
| Exit | Meaning | Fix |
|---|---|---|
| 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 logins | your 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.
More detail: Troubleshooting · Install guide · Sandbox · Tester guide