Last updated: April 16, 2026
Uninstall Naqi
Quickest path (keeps your data and backups)
Open Naqi → Settings → Danger Zone → Factory Reset. This clears in-app state and resets client configs (with a backup created first). Then quit Naqi and drag the app to the Trash.
This is enough for most users. If you want a fully clean system with every trace of Naqi removed — including caches, preferences, and keychain entries — follow the platform-specific instructions below.
macOS — full clean uninstall
1. Quit Naqi from the Dock or the app menu.
2. Delete the app bundle:
mv /Applications/Naqi.app ~/.Trash/
3. Remove all Naqi data, caches, logs, and preferences:
rm -rf ~/.naqi rm -rf ~/Library/Application\ Support/app.naqi.desktop rm -rf ~/Library/Caches/app.naqi.desktop rm -rf ~/Library/Logs/app.naqi.desktop rm -f ~/Library/Preferences/naqi.plist rm -f ~/Library/Preferences/app.naqi.desktop.plist rm -f ~/Library/LaunchAgents/app.naqi.desktop.plist
The LaunchAgents file only exists if you enabled "Start at login" in Settings — safe to run either way.
4. Remove keychain entries (license key and any AI provider API keys you stored in Naqi):
security delete-generic-password -s "app.naqi.desktop" 2>/dev/null # Repeat the command until it prints: # "SecKeychainSearchCopyNext: The specified item could not be found in the keychain."
Or use Keychain Access.app: search for app.naqi.desktop and delete each matching entry.
5. Empty the Trash. Done.
Windows — full clean uninstall
1. Uninstall via Settings: Settings → Apps → Installed apps → Naqi → Uninstall. The NSIS uninstaller removes the program files.
2. Remove leftover data and caches in PowerShell:
Remove-Item -Recurse -Force "$HOME\.naqi" Remove-Item -Recurse -Force "$env:APPDATA\app.naqi.desktop" Remove-Item -Recurse -Force "$env:LOCALAPPDATA\app.naqi.desktop"
3. Remove credentials (license key + any AI provider API keys) from the Windows Credential Manager: Control Panel → User Accounts → Credential Manager → Windows Credentials. Search for app.naqi.desktop and remove each entry.
Linux — full clean uninstall
1. Remove the package:
.debinstall (Debian/Ubuntu):sudo apt remove naqi.AppImage: justrmthe AppImage file you downloaded.
2. Remove data, caches, and config:
rm -rf ~/.naqi rm -rf ~/.config/app.naqi.desktop rm -rf ~/.cache/app.naqi.desktop rm -rf ~/.local/share/app.naqi.desktop
3. Remove Secret Service (keyring) entries for the license key and any AI provider API keys. Open seahorse (GNOME Keyring) or kwalletmanager (KDE Wallet), search for app.naqi.desktop, and delete each entry.
What's in each location (transparency)
Naqi is privacy-first, so it's worth knowing exactly what's stored locally. On macOS, the paths above contain:
~/.naqi/— all your Naqi data: config, scan history, token history, versioned backups, undo stack, scheduled-scan metadata, security audit exports. This is the single source of truth for user data.~/Library/Application Support/app.naqi.desktop/WebKit/— the Tauri/WebView cache for the UI. Can be regenerated, safe to delete.~/Library/Preferences/naqi.plist— macOS-managed window state (size, position).~/Library/Logs/app.naqi.desktop/— debug logs.- Keychain entry
app.naqi.desktop— your Pro license key and any AI provider API keys you chose to store in Naqi (these are never written to disk in plaintext).
Something didn't work?
Email support@getnaqi.com with the platform and the step that failed. We'll walk you through it.