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

Getting Started

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

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.

Platform Overview

GlobalStacks organizes creation workflows, product operations, and secure execution capacity into Studio, Products, and Infra.

Runtime Layer

GlobalStacks separates runtime profiles from providers so Docker, Firecracker micro virtual machines (microVMs), and future runtimes can be reported, placed, and audited explicitly.

Getting Started

Sign in to GlobalStacks, open the console, and connect your first host.

Understand the GlobalStacks host agent, its control-plane connection, CLI touchpoints, and runtime responsibilities.

Platform Overview

Understand GlobalStacks as Studio, Products, and Infra for creating, shipping, and operating software on secure runtime capacity.

Learn how GlobalStacks models sandboxes, runtime profiles, placement, managed-capacity agents, and Firecracker micro virtual machine (microVM) isolation.

Understand how GlobalStacks provides private runtime networks, policy-checked routing, network-layer firewalling, and port forwarding.

Build App Platforms

Use GlobalStacks as the runtime and network substrate for preview environments, internal developer platforms, continuous integration (CI) fleets, or Vercel-like hosting on your own infrastructure.

Managed Infrastructure

Learn how GlobalStacks models providers, capacity pools, machines, planned provisioning, runtime profiles, and managed-capacity enrollment.

Extensibility Model

Understand how GlobalStacks uses extensions for provider integrations, storage, runtime operations, user interface (UI) surfaces, and brokered permissions.

Security and Isolation

Learn how GlobalStacks separates Docker containers, Firecracker micro virtual machines (microVMs), tenant boundaries, provider hosts, network policy, and secrets.

Reference Architectures

Explore common platform patterns built on GlobalStacks, including internal developer platforms, preview environments, continuous integration (CI) fleets, and customer-hosted app platforms.

Building Extensions

Build GlobalStacks extensions with manifest-driven permissions, host viewports, sandboxed iframes, and brokered UI.

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.

Product Adoption

Generate a reviewable GlobalStacks product configuration from an existing repository.

Install gstacks, authenticate against the control plane, and run common operator workflows.

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.

Hosts provision isolated sandboxes. Connect a host, verify connectivity, and understand how token revocation affects sandbox placement.

Configure write-only secrets, outbound egress policies, and sandbox Access grants without placing long-lived credentials in sandbox definitions.

Create runtime networks, publish sandbox aliases, test policy, and join the mesh from local development machines.

End-user release notes for GlobalStacks.

Install gstacks and inspect available CLI and agent release artifacts.