Uninstall Cosmonic Desktop
Removing Cosmonic Desktop takes two steps: remove the app, its daemon service, and its tray, then optionally remove stored state.
On macOS and Linux, the daemon ships a purpose-built cleanup command, cosmonicd uninstall, which stops and deregisters the daemon service, the tray, and the app's login items—use it rather than picking services apart by hand. On Windows, use the app's uninstaller, which handles the equivalent cleanup.
1. Remove the app
- macOS
- Windows
- Linux
Run the cleanup command before deleting the app (the binary lives inside it), then remove the app bundle:
"/Applications/Cosmonic Desktop.app/Contents/Resources/cosmonicd" uninstall
rm -rf "/Applications/Cosmonic Desktop.app"The first command boots out and removes the daemon, tray, and app LaunchAgents; the second removes the app itself.
Quit the app, then uninstall Cosmonic Desktop from Settings → Apps → Installed apps. The uninstaller removes the app along with the daemon and tray autostart entries.
If you installed the .deb (or .rpm), the package manager's removal scripts stop and deregister the service:
sudo apt remove cosmonic-desktopIf you installed the AppImage, stop and remove the user service and autostart entries the app configured, then delete the AppImage:
systemctl --user disable --now cosmonicd.service 2>/dev/null
rm -f ~/.config/systemd/user/cosmonicd.service ~/.config/autostart/cosmonic-*.desktop
rm ~/.local/bin/cosmonic-desktop*.AppImage2. Remove stored state (optional)
Uninstalling the app leaves your Workload specs and the image cache in place, so a reinstall picks up where you left off. To remove them too, delete the state directory:
| Platform | State directory |
|---|---|
| macOS | ~/Library/Application Support/Cosmonic |
| Linux | $XDG_DATA_HOME/cosmonic (default ~/.local/share/cosmonic) |
| Windows | %APPDATA%\Cosmonic |
If you set COSMONIC_STATE_DIR, delete that location instead. (Running cosmonicd uninstall --purge in step 1 removes the state directory—and the secret values Cosmonic stored in your OS keychain—for you.)
Manually deleting the state directory doesn't touch secret backends. On macOS and Linux, cosmonicd uninstall --purge now also clears the secret values Cosmonic stored in your OS keychain. Secrets you referenced in 1Password or AWS Secrets Manager live in those external stores and are never removed—delete them there if you want them gone. On Windows, the app uninstaller leaves Credential Manager entries in place; remove any Cosmonic entries separately.