Skip to content

Activation failures

When the activation screen rejects your key or never gets past loading.

Available on
  • Desktop
  • CLI Daemon

Activation talks to our cloud relay to verify your key and register the machine. Anything that can go wrong with that handshake shows up here.

”Invalid API key”

The key wasn’t found. Most often:

  • A trailing space or newline got included when copy-pasting.
  • The wrong key was pasted.
  • The key was already used and then deleted.

Fix:

  1. Open the portal. Settings > Hosts.
  2. Find the key. Confirm it’s marked as Unused.
  3. Copy it again, paste it into the desktop. No spaces, no quotes.
  4. Click Activate.

If the key is marked Activated in the portal, it’s already been used. Generate a fresh one.

Host limit reached

If activation refuses because your account is at its plan’s host cap, the key isn’t consumed (you’ll see it still marked Unused in the portal).

Options:

  • Revoke an unused host. Open the portal, Settings > Hosts, find one that’s offline or no longer needed, click Revoke. Try activation again.
  • Upgrade your plan. Open the portal, Settings > Billing.
  • Add an extra host slot. Each plan above Free supports per-slot upgrades. Open Settings > Billing > Hosts.

”Network error” / “Couldn’t reach the relay”

Activation requires an outbound HTTPS connection to our cloud relay. If the desktop can’t reach the relay:

  1. Confirm your machine is online (open a browser, load any website).
  2. If you’re on a corporate network, your firewall may be blocking the connection. Allowlist *.glueprint.ai over HTTPS.
  3. If you’re behind an HTTP proxy, set the standard HTTPS_PROXY environment variable before launching Glueprint.

The key isn’t consumed on network failure. Click Activate again once your network is fixed.

Activation hangs or takes a long time

Most activations complete in a few seconds. If you’ve waited more than 30 seconds:

  1. Cancel the activation.
  2. Force-quit the app.
  3. Check the relay status page at status.glueprint.ai.
  4. Retry.

If the relay is up but activation still hangs, contact support with the key (the unused one is fine to share; revoke it after we look).

”Key already activated”

Each key activates one host. Once used, you can’t reuse it on another machine. Generate a new key from the portal.

If you think this is a mistake (you’ve never activated, but the key shows as activated), check that no other person on your account activated it. If it’s truly orphaned, contact support — we can clear it.

”Account suspended”

Means your subscription is paused due to payment failure, or your administrator has paused the account. Open the portal and check Settings > Billing.

Activation succeeds, then the app freezes

The activation handshake succeeded but the next step (initializing the local state) failed. Try:

  1. Quit the app.
  2. Move your data directory aside (back up first). See Settings > About for the path.
  3. Relaunch. You’ll see the activation screen again. Re-activate with the same key — it should work because the prior key is now associated with your account.

If it still freezes, send us your logs (see Contact support).

PreviousInstall issues
NextSync and relay issues