Skip to main content
1

Install the CLI

curl -fsSL https://www.dedaluslabs.ai/install/dedalus | bash
2

Set your API key

Get a key from the Dashboard.
export DEDALUS_API_KEY=<your-key>
3

Create a machine

dedalus machines create --vcpu 1 --memory-mib 1024 --storage-gib 10 --autosleep never
Note the machine_id (starts with dm-).
4

Run a command

SSH is the fastest path when you’re following along interactively. The CLI runs commands directly, without opening a shell. Do anything you’d like on a full Linux computer.
dedalus ssh <machine_id>

# Inside the machine:
whoami && uname -a

​
Use Dedalus Machines programmatically

Dedalus Machines work from both the CLI and SDKs. The example below creates a machine, runs a command, and prints its output. 
dedalus machines create --vcpu 1 --memory-mib 1024 --storage-gib 10
dedalus machines executions create \
  --machine-id <machine_id> \
  --command '["/bin/bash", "-c", "whoami && uname -a"]'
dedalus machines executions output --machine-id <machine_id> --execution-id <exec_id>
Now sleep, wake, watch, or delete the machine: Lifecycle.
Last modified on May 21, 2026