Skip to main content

​
System Requirements

  • macOS: 12.0+ (Apple Silicon or Intel)
  • Linux: Ubuntu 20.04+, Debian 11+, or any systemd-based distro
  • Memory: 2GB+ recommended
  • Disk: 5GB for runtime images

​
Install the Daemon

1

Start Lima VM

Orpheus runs in a Lima VM on macOS for Linux compatibility:
orpheus vm start
This downloads and starts the Orpheus VM (~5 minutes first time).
2

Verify Running

orpheus status
Should show: ✓ healthy

​
Install the CLI

The Orpheus CLI lets you deploy and manage agents: 
npm install -g @orpheus/cli
Verify installation: 
orpheus --version

​
Verify Installation

Run the healthcheck command:
orpheus healthcheck
Expected output: 
✓ Daemon running
✓ Worker pools healthy
✓ Storage accessible

​
Next Steps

Deploy Your First Agent

Follow the quick start guide →

​
Troubleshooting

Check if port 7777 is in use:
lsof -i :7777
Kill conflicting process or change port in config.
On Linux, you may need sudo:
sudo orpheusd start
Or add your user to the orpheus group.
Install Lima first:
brew install lima
Then retry orpheus vm start.