← Schema index / Config Reference

updates schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Auto-update configuration — version checking and self-update behaviour.

Field pathTypeRequiredDefaultCanonical description
updatessectionoptionalAuto-update configuration — version checking and self-update behaviour.
└ updates.auto_updatebooloptionalfalseAutomatically download newer releases.
└ updates.channelstringoptionalstableRelease channel: stable, nightly, hourly, dev, latest.
└ updates.github_repostringoptionalharryaskham/cacophonyGitHub repository in owner/repo form.
└ updates.identitystringoptionalIdentity name for gh auth token resolution on multi-account setups.
└ updates.restart_on_updatebooloptionalfalseAuto-restart daemon to pick up new releases when no transient agents are running.
└ updates.restart_grace_period_secsu64optional60Grace period in seconds before auto-restart for update.
└ updates.force_restart_on_updatebooloptionalfalseForce-restart even with non-persistent agents running.
└ updates.launcher_archive_countusizeoptional1Previous launcher binaries to retain for rollback.
└ updates.stabilize_timeout_secsu64optional240Restart/update health stabilization timeout before launcher rollback.
└ updates.androidmapoptionalAndroid companion APK update targets for first-party update orchestration.
└ updates.android.autobooloptionalfalseEnable configured Android companion APK updates during update orchestration.
└ updates.android.packagestringoptionalcom.cacophony.companionAndroid package name to inspect/install.
└ updates.android.artifactstringoptionalcacophony-companion.apkGitHub release APK asset name.
└ updates.android.targetslist[map]optionalExplicit adb update targets.
└ updates.android.targets.namestringoptionalOptional target name.
└ updates.android.targets.host_nodestringoptionalNode that owns adb connectivity; omitted means local node.
└ updates.android.targets.serialstringrequiredadb serial such as sgu24:5555.
└ updates.android.targets.enabledbooloptionaltrueWhether this target participates in update checks/installs.