Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

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.