Installation
Download and install Agents Machine on macOS, Linux, or Windows.
Prerequisites
- Docker Desktop — installed and running (download here)
- Agents Machine account — sign up at agents-machine.com
Download
Log in to your dashboard and download the installer for your platform:
| Platform | File | Architecture |
|---|---|---|
| macOS (Apple Silicon) | .dmg | ARM64 (M1/M2/M3/M4) |
| macOS (Intel) | .dmg | x86_64 |
| Linux | .deb | x86_64 |
| Windows | .exe | x86_64 |
Platform Instructions
Open the DMG
Double-click the downloaded .dmg file.
Drag to Applications
Drag Agents Machine into your Applications folder.
Bypass Gatekeeper
On first launch, macOS shows a "can't be verified" warning (ad-hoc code signing).
Right-click the app → Open → click Open in the dialog. You only need to do this once.
If you see an "App is damaged" error instead, run this in Terminal and try again:
xattr -cr /Applications/agents-machine.appInstall the .deb package:
sudo dpkg -i agents-machine_*.debIf dependencies are missing:
sudo apt-get install -f
sudo dpkg -i agents-machine_*.debRun the Installer
Double-click the downloaded .exe file.
Follow the Prompts
Complete the installation wizard.
Launch
Open Agents Machine from the Start menu.
First Launch
Authenticate Log in via GitHub (device authorization flow) or enter
your license key.
Docker Infrastructure The app verifies Docker is running, then
auto-starts PostgreSQL and Qdrant containers via Docker Compose.
MCP Server The bundled MCP server starts as a sidecar process on port
3000. You can monitor progress on the loading screen.
After the first launch, subsequent startups are much faster — Docker containers resume from their existing state.
Updating
The app checks for updates automatically via Tauri's built-in updater. When a new version is available, a notification appears in the app.