Skip to main content
RemoteHost runs agent sandboxes (qemu or firecracker VMs) in projects within an organization, created and operated through its REST API, SDK and CLI. The following table shows what CostGraph runs on this provider.

​
Connect

Run the dispatcher with provider set to remotehost and these variables:
  • REMOTEHOST_API_KEY
  • REMOTEHOST_ORG_ID
  • REMOTEHOST_PROJECT_ID

​
Key and permissions

REMOTEHOST_API_KEY is a RemoteHost API key (rh_sk_…), created in the console under API keys or with “remote keys create “—name <n>” “—template platform“ (default template ci; keys expire after 90 days by default). REMOTEHOST_ORG_ID is the organization id (GET /v1/me/orgs lists orgs the key can reach); REMOTEHOST_PROJECT_ID is the project the sandboxes belong to. Keys are scoped by template or explicit --scope. The default ‘ci’ template lets a key create, run in and clean up sandboxes; ‘platform’ grants what a product backend needs. Named scopes include sandbox.read (list/retrieve), sandbox.create (create/update/attach/fork) and sandbox.stop; the scope names for exec and destroy are not documented on the endpoint pages. Keys are limited to one org and can be pinned to one workspace. Sources: docs.remotehost.ai: sdk, docs.remotehost.ai: cli reference, docs.remotehost.ai: platform, docs.remotehost.ai: concepts, docs.remotehost.ai: exec sandbox command.

​
Limits

  • Exec timeoutSeconds 1-600 (default 120); stdout/stderr each capped at 64 KiB. (source)
  • Documented machine sizes: small 2 vCPU/4 GB, default 4 vCPU/8 GB, large 8 vCPU/16 GB (no xlarge listed). (source)
  • Plan required after a 7-day trial (402 plan_required); plan limits return rate_limited or limit_reached; setup scripts max 30 minutes. Max lifetime, idle stop, regions and arch are not documented. (source)