Skip to main content

Windows

Desktop installer​

Run the supplied Timon NSIS installer, choose its installation directory and open Timon. It registers the daemon as the TimonOrchestrator scheduled task at logon, using the current user's privileges. This is not a Windows NT service and does not require an administrator service wrapper.

Follow First run. Install and sign in to your CLI backend under the same Windows account. Keep agent working directories as existing absolute Windows paths; a Linux or container path is not interchangeable with one.

Setup detects npm-installed backends without restarting Timon, including installations with a custom global npm directory. If you explicitly configured a backend path in host.binaries, that path takes precedence; timon doctor reports it when the file is missing. Correct or remove the outdated path in your configuration.

Uninstalling​

Uninstall Timon from Windows Settings or Control Panel. Allow the Windows permission prompt to remove the TimonOrchestrator scheduled task. Your Timon data directory, including missions, agents and the database, is kept.

For unattended removal, run the installed uninstaller with /S from an administrator terminal. Silent removal does not ask for elevation. If permission is denied, removal of the application continues; remove any remaining TimonOrchestrator task from Task Scheduler with administrator rights.

Source installation​

For a source checkout, install Node 22+, Git and the native build prerequisites. In PowerShell, from the checkout root:

cd orchestrator
npm ci
npm run build
cd ../app
npm ci
npm run build
cd ..
node orchestrator/bin/timon service install --dry-run

Before installing, set profile to windows, daemon.supervisor to windows, daemon.installDir to the absolute orchestrator directory and app.enabled to true in the configuration file. Escape backslashes in JSON or use forward slashes.

node orchestrator/bin/timon service install
node orchestrator/bin/timon service status

The task starts at logon. If it is registered but not running, start it from Windows Task Scheduler or sign out and back in before completing setup. Removing the supervisor does not remove Timon's data directory.