Skip to main content
boxd runs persistent, hardware-isolated Linux machines that boot in milliseconds, fork and snapshot, and hibernate when idle. The following table shows what CostGraph runs on this provider.

Connect

Run the dispatcher with provider set to boxd and these variables:
  • BOXD_API_KEY

Key and permissions

BOXD_API_KEY is a boxd API key (prefix bxd_) minted with boxd auth keys create <name> after browser login; optional --expires-in-secs", "--org", and "--kind org (userless service key, org admin only). Keys have no permission scopes: every key is fenced to one organization. The default --kind member key acts as its creator within that org (full access to what the user can do there); --kind org is limited to the org’s shared machines. A member key is sufficient. Sources: docs.boxd.sh: authentication, docs.boxd.sh: resources, docs.boxd.sh: suspend resume, docs.boxd.sh: regions.

Limits

  • Auto-hibernate on by default after 4 hours without TCP/UDP traffic in either direction; auto-suspend (standby) is off by default. Both are tunable or can be disabled per machine. (source)
  • Sizes 1/2/4/8 vCPU with 4/8/16/32 GiB (default 2 vCPU / 8 GiB), 100 GB fixed disk; quota max 8 vCPU / 32 GiB per machine unless raised. (source)
  • 50 machines per organization per region (hibernated and stopped count); 2 machines without a payment method. (source)
  • Regions: Frankfurt (fra) and New York (nyc). (source)