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

​
List machines

Returns every machine in your account, including sleeping ones. 
dedalus machines list

​
Get machine details

Point-in-time snapshot per machine. Return its configs such as full machine object: id, phase, vcpu/memory/storage, autosleep policy, IP, timestamps. 
dedalus machines retrieve --machine-id <machine_id>
​
machine_id
string
required
The machine to retrieve.

​
Watch

Streams the machine’s current state every time it changes in the life cycle. Most commonly used to monitor for phase transitions (sleep, wake, delete). The stream closes once the machine reaches a stable phase. 
dedalus machines watch --machine-id <machine_id>
​
machine_id
string
required
The machine whose lifecycle stream you want to watch.

​
Auto-sleep

Machines auto-sleep after 5 minutes of no activity by default. Set autosleep on create or update to change the policy for one machine. Use never to disable auto-sleep. Activity is any successful execution, terminal/SSH session, or preview hit. Background processes inside the VM do not count. 
dedalus machines update --machine-id <machine_id> --autosleep 15m
​
autosleep
string
Idle window before auto-sleep. Accepts fixed units like 30s, 15m, 2h, 1w3d, raw seconds like "1800", or never.

​
Sleep

Zero compute cost. Storage persists. 
dedalus machines sleep --machine-id <machine_id>

​
Wake

dedalus machines wake --machine-id <machine_id>
​
machine_id
string
required
The machine to sleep or wake.

​
Delete

Delete the machine and its storage. 
dedalus machines delete --machine-id <machine_id>
​
machine_id
string
required
The machine to delete.
Deletion is permanent. All storage is wiped. There is no undo.
Last modified on May 14, 2026