Skip to main content
Prints the current state of your tenant’s pool. Shows how many warm VMs are available and lists each one by name and task queue.

​
Synopsis

murmur pool status [flags]
Pool commands run from your laptop only. They are not available on agent VMs.

​
Arguments

NameTypeRequiredDescription
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

The output starts with a warm: count line, followed by one indented line per warm VM.
FieldDescription
warmTotal number of warm VMs in the pool.
Per-VM lineThe VM’s instance name and task queue.

​
Examples

​
Pool with warm VMs

murmur pool status

warm: 3
  warm: murmur-a1b2c3d4 (murmur-a1b2c3d4)
  warm: murmur-e5f6g7h8 (murmur-e5f6g7h8)
  warm: murmur-i9j0k1l2 (murmur-i9j0k1l2)
Three VMs are pre-booted and ready. The next murmur spawn claims one instantly.

​
Empty pool

murmur pool status

warm: 0
No warm VMs are available. The next murmur spawn triggers a cold boot, which takes longer. Use murmur pool up to ensure the pool is running and backfilling.

​
Errors

CodeMeaningWhat to do
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
PERMISSION_DENIEDYour role does not have pool-config.read permission.Ask a tenant admin to grant you the required permission.
(exit error)pool commands are not supported on VMsRun this command from your laptop, not from an agent VM.