Activation failures — Glueprint Docs

Desktop setup has two parts: browser sign-in, then host registration. The recovery action depends on which part failed and whether the server already created or claimed a host.

Start with Activate your account for the normal flow.

The browser does not return to the desktop

In the browser, click The app didn’t open?, then click Copy in the Sign-in link panel. In the desktop, expand Use an authorization code instead, paste the complete link into Authorization code or sign-in link, and click Submit.

Secure registration needs the complete sign-in link. A bare authorization code cannot carry the secure registration handoff. The link expires after five minutes and can be used once.

Opening the paste form during the current browser wait preserves that attempt. Open browser again starts a new attempt; use the link produced by the new attempt.

If email verification completed in a different browser tab, return to the tab opened by the desktop. If that flow is no longer available, start another sign-in from the desktop.

Continue in browser

After a restart or expiry, the desktop may remember your account but no longer have the temporary secure registration handoff. The host list remains read-only.

Click Continue in browser, complete the browser flow, and wait for Available hosts to refresh.

If a host was already created or claimed and Try again is offered, use the retained activation retry described below before starting another sign-in.

No host is available to claim

Members cannot create hosts. If you see Ask an owner or admin to create a host for you, ask an owner or admin to prepare a pending desktop host assigned to you, then click Refresh hosts.

A host assigned to another member is not claimable merely because you can see it. Already activated hosts and CLI daemon hosts are not desktop claim candidates.

Host limit reached

Pending host entries already consume slots when created. The limit prevents creating another host; it does not prevent claiming an eligible existing desktop host.

Use Manage billing when available to open the portal’s billing page. Otherwise follow Ask an owner or admin to add a host. An owner or admin can also review and revoke an unneeded host under Settings > Hosts.

After capacity changes, click Refresh hosts.

A host was created or claimed, but activation did not finish

The desktop distinguishes these two messages:

The host was created, but activation did not finish. Retry activation without creating another host.
The host was claimed, but activation did not finish. Retry activation without claiming it again.

When Try again is available, click it to finish activation of that same host. There is one explicit retry. It does not create another host or claim the host again.

Keep the desktop open and use that action before starting another browser sign-in. Restarting the desktop or starting another sign-in clears the retained activation key.

The retry expired or failed again

The desktop may show:

Activation could not be completed. The host still exists. Sign in again and review it before creating another host.
The activation retry expired. Sign in again and review the existing host before creating another host.
The server may have saved this host registration. Sign in again and refresh the host list before trying another create or claim.

Follow Continue in browser and review the refreshed host inventory. A refresh alone does not resolve a locally known uncertain operation.

After a restart, a host that is still pending may be claimed through a new secure sign-in. If the server already activated the host but this desktop could not save its credential, pending-host claiming cannot recover that activated row. Ask an owner or admin to review the existing registration; do not assume another create will repair it.

A selected host disappeared or cannot be claimed

For Agent host not found or Host is not claimable, click Refresh hosts and review the current entries. The host may have been removed, claimed, or activated since the list loaded.

For a permission error, review the host assignment with an owner or admin. A permission error does not by itself mean the account is at its host limit.

The server does not support claiming

If the message is This server can’t claim pending hosts yet. Create a new host instead., this server does not provide pending-host claiming.

Creating remains available only to owners and admins with capacity. Other users should ask an owner or admin for help with an appropriate desktop host key or server upgrade. See Hosts and activation keys.

Network errors or a stalled operation

Check the machine’s network connection, then relaunch the app and retry.

On a corporate network, allowlist *.glueprint.ai over HTTPS. If you use an HTTP proxy, set the standard HTTPS_PROXY environment variable before launching Glueprint.

Use the action appropriate to the displayed state:

Retry after a host-list failure reloads the list.
Try again after a confirmed create or claim retries activation of the existing host.
Continue in browser renews secure registration when required.

A failed network request can still have reached the server. Do not assume it left no host behind, and do not repeatedly create replacements.

If an operation remains stuck or the app freezes, contact support with the error text and the host label or identifier. Exclude host keys, authorization codes, complete sign-in links, and tokens. See Contact support.

”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.

”Invalid API key”

This applies to the alternative key path and CLI activation.

Check that you copied the correct unused key and selected the correct host type. On the desktop, use Have a host key? Enter it instead, paste into One-time host key, and click Register host.

The portal displays a newly created key once; it cannot show you the original text again. If an eligible desktop host is still pending, you can instead sign in and claim it with Use this host.

After reviewing the existing host, prepare a replacement through the path for your plan:

Free: open Home and follow the desktop setup checklist. Or open Settings > Hosts and find Set up your included host. Click Download; the same button then reads Continue setup and returns you to the Home checklist. Enter Name this Desktop, then click Create one-time host key.
Pro, Team, or Enterprise: open Settings > Hosts, click Create Host, choose the appropriate Host type, enter a Label, and click Create Host to confirm.

”Key already activated”

A host key cannot register another machine after it is bound. A previous key also stops working after the pending host is claimed with a replacement key.

Review the existing host before preparing another one. Do not remove local registration data on the assumption that the same one-time key can repeat the original activation.

An already registered desktop shows Welcome back when a user needs to sign in. Use an account that belongs to the registered host’s organization and can access that host.

This sign-in checks the existing host binding. It does not create another host or open the host picker.