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.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.
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 withmust run as root or leaves items behind, see Desktop app errors.
Next steps
- Offboard member: End the person’s access in Atlan too.
See also
- Deploy Atlan Trident Desktop to managed Macs: Install Atlan on managed Macs.
- Manage Atlan Trident Desktop updates: Choose who updates the app.