GlobalStacks logo GlobalStacks Documentation
Open app
Documentation

Get started with GlobalStacks.

Sign in, connect a host, authenticate the CLI, and start using the control plane.

Quick start
curl -fsSL https://app.globalstacks.dev/install.sh | sh -s -- --role provisioning
curl -fsSL https://app.globalstacks.dev/cli/install.sh | sh -s -- --base-url https://app.globalstacks.dev --auth device
Start here
Start Here

Getting Started

Access the control plane, create a provisioning token, install the host agent, and verify host telemetry, logs, and terminal access.

→
Start Here

Host Agent

Learn how the host agent enrolls infrastructure, keeps a typed control connection, and manages sandbox, network, terminal, and runtime work on connected hosts.

→
Extensions

Building Extensions

Learn the extension project shape, manifest contract, viewport model, permission purposes, and sandboxed iframe UI flow.

→
Extensions

Design System

Use the current console design language for color, typography, surfaces, actions, forms, status, tables, dialogs, logs, and sandboxed extension UI.

→
Start Here
Setup, architecture, and first-run flows.
Getting Started
Sign in to GlobalStacks, open the console, and connect your first host.
→
Host Agent
Understand the GlobalStacks host agent, its control-plane connection, CLI touchpoints, and runtime responsibilities.
→
Extensions
Build extension UI, manifests, and host-rendered components.
Building Extensions
Build GlobalStacks extensions with manifest-driven permissions, host viewports, sandboxed iframes, and brokered UI.
→
Design System
Design GlobalStacks console and extension interfaces with the current product tokens, surfaces, components, and interaction patterns.
→
Style Extension UI
Style GlobalStacks extension views with approved tokens, layout props, spacing, sizing, and preset component styles.
→
Extension Component Library
Reference the sandboxed extension UI components, layout patterns, and style rules for GlobalStacks extensions.
→
Reference
CLI and API details that should stay precise.
CLI
Install gstacks, authenticate against the control plane, and run common operator workflows.
→
CLI Reference
Exact command reference for gstacks.
→
API and Contracts
GlobalStacks ships OpenAPI and protobuf contract sources for the HTTP control plane and agent-control WebSocket surface.
→
Operations
Runbooks, sandbox behavior, networking, and volume guidance.
Sandboxes
Hosts provision isolated sandboxes. Connect a host, verify connectivity, and understand how token revocation affects sandbox placement.
→
Access
Configure write-only secrets, outbound egress policies, and sandbox Access grants without placing long-lived credentials in sandbox definitions.
→
Networks
Create runtime networks, publish sandbox aliases, test policy, and join the mesh from local development machines.
→
Changelog
End-user release notes for GlobalStacks.
→
Releases
Install gstacks and inspect available CLI and agent release artefacts.
→