Skip to main content

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

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.

2. 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:

PlatformState 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.)

Secrets in your keychain

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.