System Manager

Control the Nimbus agent lifecycle and manage installed versions.

nimbus system <command>

Command	Description
status	Show agent status (default command)
log	Show system log
loglevel	Change minimal log level (debug, info, warning, error)
upgrade / stop-upgrade	Upgrade or cancel upgrade
link	Show installation command and API key
login <api-key>	Set API key
start / stop / reload	Manage service process
factory-reset	Reset agent to default settings and reload
db-backups	List restorable local database backups created by factory reset or restore
db-restore <id> [--no-restart]	Schedule restore of a listed local database backup by id; restarts the service by default
service-status	Show nimbusd service status
log-service	Show service logs
uninstall	Remove Nimbus agent
prune	Clean temp files and unused layers
agent-version	Show current version
agent-list	List available backups
agent-backup <name>	Create version backup
agent-revert <name>	Revert to a backup version
agent-clean-backup	Remove all local backups
storage	Show storage info

Example

nimbus system agent-backup yakir

→ Creates backup folder /etc/nimbus/yakir/

nimbus system db-backups
nimbus system db-restore agent-db-factory-reset-20260705T100000Z-...

→ db-backups shows only restorable operator backups such as agent-db-factory-reset-* and agent-db-pre-restore-*. Internal migration snapshots are hidden. db-restore rejects ids that are not listed and writes a pending-restore marker. The restore is applied at the next Nimbus process start before runtime storage opens SQLite; by default the command requests that restart immediately.

---