Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dedaluslabs.ai/llms.txt

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

Machines have four : running, sleeping, starting, and destroyed. You control transitions between them.

​
List machines

dedalus machines list

​
Get machine details

dedalus machines retrieve --machine-id <machine_id>
​
machine_id
string
required
The machine to retrieve.

​
Watch

Observe phase transitions over Server-Sent Events. The stream closes once the machine reaches its desired state. 
dedalus machines watch --machine-id <machine_id>
​
machine_id
string
required
The machine whose lifecycle stream you want to watch.

​
Sleep

Zero compute cost. Storage persists. Wake takes a few seconds. 
dedalus machines sleep --machine-id <machine_id> --if-match <revision>

​
Wake

dedalus machines wake --machine-id <machine_id> --if-match <revision>
​
machine_id
string
required
The machine to sleep or wake.
​
If-Match
string
required
The machine revision from a recent retrieve. Prevents writes from stale state.

​
Resize

Hotplug all three dimensions live: vCPU, memory, storage. No reboot, no downtime. 
dedalus machines update --machine-id <machine_id> --if-match <revision> --vcpu 4 --memory-mib 8192 --storage-gib 50
​
machine_id
string
required
The machine to resize.
​
If-Match
string
required
The machine revision from a recent retrieve.
​
vcpu
number
Target CPU count in vCPUs. Supports quarter-vCPU increments.
​
memory_mib
integer
Target memory in MiB.
​
storage_gib
integer
Target disk size in GiB. Storage can grow, not shrink.
All three fields are optional — pass only what you want to change. The resize applies immediately to the running VM via ACPI hotplug (CPU/memory) and online filesystem grow (storage).

​
Delete

Grab the revision from the retrieve output. This prevents accidental deletes from stale state. 
dedalus machines delete --machine-id <machine_id> --if-match <revision>
​
machine_id
string
required
The machine to delete.
​
If-Match
string
required
The machine revision from a recent retrieve.

​
Idle auto-sleep

Machines auto-sleep after 300 seconds (5 minutes) of no activity. Per-machine idle-sleep tuning is not exposed in the public API today. Activity is any successful execution, terminal/SSH session, or preview hit. Background processes inside the VM do not count — a machine running top in a detached screen will still auto-sleep.

​
Examples

OpenClaw on Dedalus

Host OpenClaw on a Dedalus Machine.
Last modified on May 2, 2026