Get FideliOS running on Windows with a single command.

​
Prerequisites

  • Windows 10 or 11 (64-bit)
  • PowerShell 5.1 or later (built-in on Windows 10+)
No other software required. The installer handles everything.

​
Install

Open PowerShell (search the Start menu for “PowerShell”) and run: 
iwr -useb https://fidelios.nl/install.ps1 | iex
The script:
  1. Checks for Node.js — installs the LTS via winget (or nvm-windows as fallback) if missing
  2. Installs the fidelios CLI globally via npm install -g fidelios@latest
  3. Runs the interactive setup wizard (fidelios onboard) when launched from a real PowerShell window
If you see a security warning about running scripts, open PowerShell as Administrator and run: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser Then retry the install command.

​
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 PowerShell window to stop FideliOS. To start it again: 
fidelios run
Your data is preserved between restarts.

​
Where Your Data Lives

DataLocation
Config%USERPROFILE%\.fidelios\instances\default\config.json
Database%USERPROFILE%\.fidelios\instances\default\db
Secrets key%USERPROFILE%\.fidelios\instances\default\secrets\master.key
Logs%USERPROFILE%\.fidelios\instances\default\logs

​
Run in the Background

Windows does not yet ship a fidelios service install command (it works on macOS and Linux today — see Service Commands). Until that lands you have two options:
  1. Task Scheduler — create a task that runs fidelios run at logon with a hidden window.
  2. nssm — wrap the CLI as a real Windows service: 
    nssm install FideliOS "C:\Path\To\node.exe" "C:\Users\you\AppData\Roaming\npm\node_modules\fidelios\dist\index.js" run
nssm start FideliOS

​
Using WSL (Optional)

If you already use Windows Subsystem for Linux (WSL), you can run the Linux installer inside your WSL terminal instead: 
curl -fsSL https://fidelios.nl/install-linux.sh | bash
Then follow the Linux install guide. The FideliOS UI is still accessible from your Windows browser at http://127.0.0.1:3100.

​
What’s Next

Core Concepts

Learn how agents, tasks, and goals fit together

Adapters

Connect FideliOS to Claude, Codex, or your own model