Where Does Nheko Store Config and Data?
Nheko Matrix client config and data folders on Linux, macOS and Windows.
Last updated
Nheko splits Matrix state between a config folder (settings, profiles) and a data folder (room cache, crypto keys, media). Both follow OS conventions.
Crypto keys are the sensitive half. Without them, verified sessions break and history stays unreadable until re-verification.
Where Nheko stores this, by platform
~/.config/nheko
Holds settings and profiles. Data folder (cache, keys, media) sits in ~/.local/share/nheko. Close Nheko before copying.
~/Library/Application Support/nheko
Same split. Use Go to Folder in Finder. Keychain may hold tokens needing re-login.
%APPDATA%\nheko
Same role. Exact inner layout can shift between Nheko releases.
Frequently asked questions
How do I move Nheko to a new machine?
Copy the nheko config folder plus the data folder with Nheko closed. Access tokens live in the OS keyring on some builds, so expect to re-login for encrypted rooms.
Notice an outdated path? Let us know.