Get FideliOS running on Linux with a single command.

​
Prerequisites

  • Ubuntu 22.04+, Debian 12+, or any modern systemd-based distribution
  • curl installed (sudo apt install curl)
  • A user account with sudo access

​
Install

Open a terminal and run: 
curl -fsSL https://fidelios.nl/install-linux.sh | bash
The script:
  1. Installs Docker if it is not already present
  2. Installs the fidelios CLI
  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 to stop FideliOS. To start it again: 
fidelios run
Your data is preserved between restarts.

​
Run as a System Service (Optional)

To keep FideliOS running in the background and have it start automatically on boot, create a systemd service: 
sudo tee /etc/systemd/system/fidelios.service > /dev/null <<EOF
[Unit]
Description=FideliOS
After=network.target

[Service]
ExecStart=/usr/local/bin/fidelios run
Restart=on-failure
User=$USER
Environment=HOME=$HOME

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now fidelios
Check status: 
sudo systemctl status fidelios
View logs: 
journalctl -u fidelios -f

​
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

​
What’s Next

Core Concepts

Learn how agents, tasks, and goals fit together

Cloud VMs

Running FideliOS on AWS, Azure, or other cloud providers