curl -fsSL https://app.globalstacks.dev/install.sh | sh -s -- --role provisioning

Get started

Before you begin

• a GlobalStacks account
• access to the control plane
• a target host that can reach the control plane over the network

Open the console

1. Open the console.
2. Sign in with a valid account.
3. Open the Infrastructure area of the console.
4. Use the default BYO cluster or create a cluster for the target infrastructure.
5. Create a provisioning token if you do not already have one.

If sign-in fails, contact the workspace owner or verify you are using the correct control-plane URL.

Connect your first host

1. Create or copy a bootstrap token from the console.
2. Install the host agent on the target host.
3. Wait for the host to appear as connected in the console.

The installer command on this page uses the current control-plane domain automatically. The installed agent registers once, then keeps a long-lived control connection for host telemetry, logs, terminal sessions, and runtime work.

Verify the result

After connection:

• the host should appear in the console
• the host overview should show the running agent version and host architecture
• the host logs page should start receiving agent operational logs
• terminal access should be available
• the host agent should remain connected without further manual steps

If the host does not appear, check:

• the bootstrap token is valid
• the host can reach the control plane
• downloads.globalstacks.dev is serving release artifacts
• the host service manager actually started gstacks-agent

Next steps

• Continue with the CLI guide to authenticate gstacks.
• Read Host Agent to understand the agent architecture, CLI touchpoints, and runtime responsibilities.
• Use Sandboxes to understand host enrollment, runtime isolation, and reconnect behavior.
• Use Sandboxes when you are ready to run AI-agent code in an isolated runtime.