Skip to main content
Uninstalling the desktop app removes Atlan, its background service, application data, and saved sign-in from a Mac. Use it to stop a computer syncing with Atlan Trident, to offboard a device or a person from a shared machine, or to reinstall cleanly. Removing someone’s access to Atlan itself is an admin action, not a device action; see Offboard member.
Moving Atlan.app to the Trash is not enough. The desktop app installs a background service, aireg, that by default starts at login and keeps uploading sessions and session files without the app. Remove it as described below.
Uninstalling stops future uploads. It does not delete what Atlan Trident already stored; see Remove stored content.

Uninstall from your own Mac

1

Quit Atlan

Quit the desktop app, so it can’t set the background service up again.
2

Remove the background service

In a terminal, preview what will be removed, then remove it:
This stops the service, removes its start-at-login entry, and deletes its folder, ~/.aireg, including its upload jobs. It also removes the skills it linked into your coding agents. If the terminal says command not found, run ~/.aireg/bin/aireg in place of aireg.
3

Remove the saved session

Delete ~/.atlanai/auth.json, the sign-in the background service used. This also signs out the atlanai command, if you use it.
4

Remove the app

Move Atlan.app from your Applications folder to the Trash.
To keep the app but stop uploads, see Stop one computer uploading.

Uninstall from managed Macs

Before you begin

Before you start, make sure you have:
  • MDM access: You can push root scripts to the Macs.
  • Script file: The script below saved as uninstall-atlan-desktop.sh.
The script removes: A user’s own skill files are never touched: they live wherever the person chose to keep them, and their content is already in your registry.
1

Preview removal

Run the script with --dry-run to print what it would remove without removing anything:
2

Run uninstall script

Push the script from your MDM as a root script:
Use its options for common cases:
  • One person on a shared machine: sudo ./uninstall-atlan-desktop.sh --user jsmith
  • Reinstall without signing everyone in again: sudo ./uninstall-atlan-desktop.sh --keep-data
3

Remove MDM profiles

The script leaves configuration profiles alone, because the Full Disk Access grant and any update policy are MDM state, not app state. Remove them from your MDM console.
4

Verify removal

Confirm /Applications/Atlan.app, ~/.aireg, and ~/Library/LaunchAgents/sh.aireg.daemon.plist are gone, and run the script with --dry-run again: it should list nothing to remove.

Troubleshooting

If the script exits with must run as root or leaves items behind, see Desktop app errors.

Next steps

See also