Setup
Portable Mode & Uninstalling
Run Gunamaya entirely from a folder with no system footprint, and know exactly what to remove if you ever want a completely clean slate.
Portable mode
By default, Gunamaya stores your settings, keybindings, extensions, and
Gunamaya AI configuration in a per-user profile directory outside your
install location.
Portable mode changes that: everything is kept in a data folder next to the
Gunamaya binary itself, so the whole thing — application and configuration
together — can live on a USB drive or be copied between machines as one unit.
Get the archive build
Portable mode requires the .zip (Windows), .tar.gz (Linux), or
unpacked application (macOS) — not the installer, since installers write
to fixed system locations by design.
Create a data folder
Extract the archive, then create a folder named exactly data next to
the Gunamaya executable (next to Gunamaya.exe on Windows, or inside the
.app bundle's contents on macOS, or next to the gunamaya binary on
Linux).
Launch normally
Gunamaya detects the data folder automatically on startup and switches
to portable mode — no flag or configuration needed. You'll see
confirmation in Help → About.
Portable mode and extensions with native dependencies
A handful of extensions compile native modules against the operating system and architecture they were installed on. If you move a portable install between machines with different operating systems or CPU architectures, reinstall any such extensions after moving rather than expecting them to work unchanged.
Where Gunamaya stores things (non-portable install)
| What | Windows | macOS | Linux |
|---|---|---|---|
| Settings & keybindings | %APPDATA%\Gunamaya | ~/Library/Application Support/Gunamaya | ~/.config/Gunamaya |
| Extensions | %USERPROFILE%\.gunamaya\extensions | ~/.gunamaya/extensions | ~/.gunamaya/extensions |
| Gunamaya AI model keys & config | %APPDATA%\Gunamaya\User\globalStorage | ~/Library/Application Support/Gunamaya/User/globalStorage | ~/.config/Gunamaya/User/globalStorage |
Fully uninstalling
Removing the application only (via your platform's uninstaller, or by
deleting Gunamaya.app / the extracted folder) leaves the directories above
in place — intentional, so a future reinstall restores your setup. To remove
absolutely everything:
Remove the configuration directories
Delete the paths listed in the table above for your platform.
Revoke any API keys, if you're done with Gunamaya AI entirely
If you added a model provider API key specifically for use with Gunamaya and won't be reinstalling, consider revoking it from that provider's dashboard as well — see Privacy & Data.