Linux
Desktop package
Use the supplied deb package, recommended during beta: it also installs the timon terminal command without requiring Node.js. AppImage remains portable and does not install a global CLI. Open Timon and follow First run. The setup flow checks tools and installs a systemd user service so that agent work can continue after the window closes.
From an authorised source checkout
Run these commands from the root of the Timon checkout:
cd orchestrator
npm ci
npm run build
npm run install:cli
cd ../app
npm ci
npm run build
cd ..
The CLI installer puts timon in ~/.local/bin; follow its PATH instructions. Set daemon.installDir to the absolute path of this checkout's orchestrator directory, following Configuration. Enable app.enabled to let the daemon serve the built app without Docker.
Inspect the service installation before applying it:
timon service install --dry-run
timon service install
timon service status
timon doctor
The user service is named timon-orchestrator. Installation requests user lingering so it can survive logout. On Linux without systemd, setup reports portable mode: closing the application also stops the embedded daemon.
Open the configured web-app address (for the configuration example, http://127.0.0.1:3100) and complete First run.
Installing or changing a daemon service is an operator action. Finish active missions first, and do not overwrite a service belonging to another checkout or data directory.