Troubleshooting

What happens when a downloaded update can't be verified, or an in-progress update fails partway through.

What a specific sign-in or single sign-on error actually means, whether it's your password, your account, or your identity provider.

"Not an administrator," a missing Recovery Kit file, a degraded restore, or "Database unreachable": what each one means.

What each specific connection-test error means, from rejected credentials to a bucket in the wrong region.

The dashboard reports "No recall" or "Reduced recall" for a workspace: what that means, and why the agent didn't simply fail instead.

What each license banner actually means, from a grace period to a device mismatch, and what fixes it.

What a specific connection error actually means, from a rejected API key to an unverified domain, and how to fix it.

Docker missing, permission errors, AppImage launch failures, port conflicts, and signature verification problems, with the fix for each.

A folder shows "Stuck" instead of "Mounted": what that means and how to clear it.

The microphone control is missing or disabled: what each specific cause means and how to fix it.

The most common first-run failure: HeartBeatAgents requires Docker Desktop running before it can launch any agent.

An agent repeatedly retries the same failed tool call instead of stopping or escalating: usually an expired credential or an autonomy setting mismatch.