Skip to main content
An environment defines how big your agent VMs are: the machine type (vCPUs, memory) and disk size. Each workspace references one environment via its environment_ref field. Environments are cloud-aware but location-independent. An environment targets a substrate (GCP or AWS), which determines the valid machine types. The placement determines where to run. You can reuse an environment across placements on the same substrate.

​
Machine types

Machine types are catalog resources that name a specific VM size: vCPUs, memory, architecture, and optional GPU. Environments reference them by name. List available machine types with murmur get machine-type. A GPU comes with the machine type: a GCE accelerator-optimized machine type or an EC2 GPU instance type; see GPU support. Most teams pick a builtin when defining an environment. You can also define your own machine type and disk type; see machine-type and disk-type, which is what a customer-managed placement in a region the builtins do not price needs. Pricing lists every builtin’s list rate and how a VM’s components are charged.

​
Creating an environment

Create environments with murmur set environment. Each environment specifies a substrate, machine type reference, disk type reference, and optional disk size. Then reference it from a workspace via the environment_ref field. See the environment reference for all fields.