Skip to main content
Use rmux configure --show when you want to inspect the final merged config for the current directory.

Core Settings

SettingEnvironment variableNotes
backendRMUX_BACKENDaws, gcp, e2b, or managed. Legacy local and cloud are still accepted.
apiBaseUrlRMUX_API_BASE_URLMainly used for backend=managed or local control-plane development.
apiKeyRMUX_API_KEYRequired for backend=managed.

AWS Settings

SettingEnvironment variableNotes
aws.regionRMUX_AWS_REGIONAWS region.
aws.vpcIdRMUX_AWS_VPC_IDVPC used for auto-discovered subnets and security groups.
aws.authModeRMUX_AWS_AUTH_MODEaws-cli, env, or access-key.
aws.profileRMUX_AWS_PROFILEAWS profile for aws-cli auth mode.
aws.accessKeyIdRMUX_AWS_ACCESS_KEY_IDAccess key for access-key auth mode.
aws.secretAccessKeyRMUX_AWS_SECRET_ACCESS_KEYSecret key for access-key auth mode.
aws.sessionTokenRMUX_AWS_SESSION_TOKENOptional session token.
aws.subnetIdsRMUX_AWS_SUBNET_IDSComma-separated subnet IDs in env-var form.
aws.securityGroupIdsRMUX_AWS_SECURITY_GROUP_IDSComma-separated security group IDs in env-var form.
aws.instanceTypeRMUX_AWS_INSTANCE_TYPEEC2 instance type.
aws.workspaceBucketRMUX_AWS_WORKSPACE_BUCKETRequired for staged flows; the default BYOC path can auto-resolve it.
aws.previewDomainRMUX_AWS_PREVIEW_DOMAINOptional preview domain.

GCP Settings

SettingEnvironment variableNotes
gcp.projectIdRMUX_GCP_PROJECT_IDRequired.
gcp.regionRMUX_GCP_REGIONOptional if zone is present.
gcp.zoneRMUX_GCP_ZONERequired in practice.
gcp.networkRMUX_GCP_NETWORKVPC network.
gcp.subnetworkRMUX_GCP_SUBNETWORKOptional subnetwork.
gcp.machineTypeRMUX_GCP_MACHINE_TYPECompute Engine machine type.
gcp.previewDomainRMUX_GCP_PREVIEW_DOMAINOptional preview domain.
The current GCP runtime does not use a workspace bucket.

E2B Settings

SettingEnvironment variableNotes
e2b.apiKeyRMUX_E2B_API_KEYRequired for backend=e2b.
e2b.templateRMUX_E2B_TEMPLATEDefaults to base.
e2b.timeoutMsRMUX_E2B_TIMEOUT_MSSandbox timeout in milliseconds.
e2b.domainRMUX_E2B_DOMAINOptional API domain override.

Managed Settings

SettingEnvironment variableNotes
managed.regionRMUX_MANAGED_REGIONManaged AWS region.
managed.subnetIdsRMUX_MANAGED_SUBNET_IDSComma-separated subnet IDs in env-var form.
managed.securityGroupIdsRMUX_MANAGED_SECURITY_GROUP_IDSComma-separated security group IDs in env-var form.
managed.instanceTypeRMUX_MANAGED_INSTANCE_TYPEEC2 instance type.
managed.workspaceBucketRMUX_MANAGED_WORKSPACE_BUCKETDeployment-managed workspace bucket.
managed.attachRoleArnRMUX_MANAGED_ATTACH_ROLE_ARNOptional role for short-lived attach credentials.
managed.previewDomainRMUX_MANAGED_PREVIEW_DOMAINOptional preview domain.

Tooling Overrides

Environment variableUse it for
RMUX_SESSION_MANAGER_PLUGIN_PATHPoint RMUX at a specific Session Manager plugin binary.
RMUX_SESSION_MANAGER_PLUGIN_DIRPoint RMUX at a directory containing the plugin.
Last modified on March 21, 2026