Hosts and activation keys
Create a host entry in the portal, get an activation key, and use it to register a machine.
- Web Portal
In Glueprint, a host is one machine connected to your account, and an activation key is the credential the host uses to connect. The portal manages both from the same page: Settings > Hosts.
What an activation key activates
One key activates one host. After activation, the key is consumed; you can’t reuse it on another machine. Create a new host entry (and a new key) for each machine.
The key is shaped gp_ plus 64 hex characters. Treat it like a password while it’s unused.
Create a host (and get its activation key)
- Open the portal.
- Settings > Hosts.
- Click Create Host.
- Fill in the form — the host name and any optional project visibility settings.
- Click Create Host again to confirm.
The key appears once. Copy it now; you won’t see it again. If you lose it before activating, delete the unused host entry from the portal and create another one.
Use the key
- Desktop — on first launch, paste the key into the activation screen. See Activate your account.
- CLI daemon — pass the key via the activate command. See CLI Daemon.
After activation
Once the key has been used, the host’s row in Settings > Hosts shows online (when the machine is running) or offline. The key has done its job and isn’t shown again.
To stop a host from accessing your account, revoke it from Settings > Hosts. Revoking is the inverse of activation: the host immediately disconnects, the host slot frees up.
Plan limits
Each host slot above the included count is paid. You can keep more pending host entries than host slots — creating an entry is free; only activation consumes a slot. If activation would put you over your plan’s cap, it’s refused and the key isn’t consumed.
Lost keys
If you create a host, copy the key, and lose your clipboard before pasting it: just delete the unused host entry from the portal and create another one. No harm done.
If you lose a key after the machine is activated, it doesn’t matter — the machine is already running. The key isn’t used again.
Security
Activation keys never travel in plaintext over the network in their final form. The desktop and CLI daemon exchange the key for credentials that go in the operating system’s secure storage, and then the key isn’t used again.
If you suspect a key has leaked before being used, delete the host entry from the portal immediately. If you suspect a key has leaked after being used, revoke the host.