Get FideliOS running on macOS with a single command.

​
Prerequisites

  • macOS 12 (Monterey) or later on either:
    • Apple Silicon (M1 / M2 / M3 / M4, including Pro / Max / Ultra) — brew lives at /opt/homebrew/
    • Intel (2020 and earlier Macs, x86_64) — brew lives at /usr/local/
  • Terminal (built-in — search Spotlight for “Terminal”)
Both architectures are first-class. The installer auto-detects your CPU, installs Homebrew at the right prefix, and the fidelios service install launchd PATH covers both /opt/homebrew/bin and /usr/local/bin so adapter CLIs resolve regardless of arch. No other software required. The installer handles everything.

​
Install

Open Terminal and run: 
curl -fsSL https://fidelios.nl/install.sh | bash
The script:
  1. Checks for Node.js and installs it if missing
  2. Installs the fidelios CLI globally
  3. Runs a quick health check

​
Start FideliOS

fidelios run
Then open http://127.0.0.1:3100 in your browser. The first time you open it, a setup wizard walks you through creating your first company and hiring your first agent.

​
Stop and Restart

Press Ctrl+C in the terminal window to stop FideliOS. To start it again: 
fidelios run
Your data is preserved between restarts.

​
Run as a Background Service

To keep FideliOS running after you close the terminal and have it start automatically at login, install it as a launchd service: 
fidelios service install
Check that it is running: 
fidelios service status
To remove the service: 
fidelios service uninstall
See Service Commands for full details.

​
Where Your Data Lives

DataLocation
Config~/.fidelios/instances/default/config.json
Database~/.fidelios/instances/default/db
Secrets key~/.fidelios/instances/default/secrets/master.key
Logs~/.fidelios/instances/default/logs

​
Access from Other Devices on the Same Network

By default FideliOS only accepts connections from your Mac. To reach it from another device (phone, tablet, another laptop), use Tailscale: 
HOST=0.0.0.0 fidelios run
Then open FideliOS using your Mac’s local IP or Tailscale address. See Tailscale Private Access for the full setup.

​
What’s Next

Core Concepts

Learn how agents, tasks, and goals fit together

Adapters

Connect FideliOS to Claude, Codex, or your own model

Updating FideliOS

Keep FideliOS up to date with the latest release