Desktop app errors

These are errors from installing, updating, and uninstalling the Atlan desktop app, and from its task notifications. Start from the symptom you see: each section below starts from one of them.

​

App cannot sign in or download components

The app opens but cannot sign in, or cannot download its components.

​

Cause

Your network blocks a host the app needs.

​

Solution

1. Compare your firewall or proxy rules with Network requirements.
2. Allow the missing hosts.
3. Restart the app and sign in again.

---

​

Update asks for administrator credentials

On a managed Mac, every update attempt asks for administrator credentials.

​

Cause

The MDM installed the app in /Applications owned by root, and the user is a standard user, so the app’s self-update cannot overwrite it.

​

Solution

1. If the app updates itself, run the ownership script in Let standard users self-update once per device, as root, after a user session exists.
2. If your MDM owns updates, push each new .pkg from the MDM instead.

---

​

App ignores update deferral

The app updates more often than the UpdateDeferralDays cadence you set.

​

Cause

The app honors the key only when it arrives as a managed preference through MDM, not when it is set locally. A required security release also overrides the cadence with an in-app warning.

​

Solution

1. Deploy UpdateDeferralDays in the com.atlan.dashboard domain as an MDM managed preference.
2. Check whether the device shows a security-floor warning; that update is required.

---

​

Uninstall script exits

The uninstall script stops with must run as root or unknown argument.

​

Cause

The script must run as root, and it accepts only --user, --dry-run, and --keep-data.

​

Solution

1. Push it from your MDM as a root script, or run it with sudo.
2. Check the options against Uninstall desktop app.

---

​

Task notification does not appear

A coding agent finishes a task, but no notice appears.

​

Cause

Atlan notifies only when no screen in Atlan shows the session, and macOS may not allow notifications from Atlan. A task you stop yourself sends no notice.

​

Solution

1. Leave the session’s page before you switch to another app.
2. On macOS, allow notifications from Atlan in System Settings.
3. Give the agent another task and confirm the notice appears.

---

​

See also

• Install desktop app: Install Atlan on one computer.
• Deploy desktop app with MDM: Install Atlan on managed Macs.

​

Need help

If you need assistance after trying these steps, contact Atlan support.