← 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 path | Type | Required | Default | Canonical description |
|---|---|---|---|---|
updates | section | optional | Auto-update configuration — version checking and self-update behaviour. | |
└ updates.auto_update | bool | optional | false | Automatically download newer releases. |
└ updates.channel | string | optional | stable | Release channel: stable, nightly, hourly, dev, latest. |
└ updates.github_repo | string | optional | harryaskham/cacophony | GitHub repository in owner/repo form. |
└ updates.identity | string | optional | Identity name for gh auth token resolution on multi-account setups. | |
└ updates.restart_on_update | bool | optional | false | Auto-restart daemon to pick up new releases when no transient agents are running. |
└ updates.restart_grace_period_secs | u64 | optional | 60 | Grace period in seconds before auto-restart for update. |
└ updates.force_restart_on_update | bool | optional | false | Force-restart even with non-persistent agents running. |
└ updates.launcher_archive_count | usize | optional | 1 | Previous launcher binaries to retain for rollback. |
└ updates.stabilize_timeout_secs | u64 | optional | 240 | Restart/update health stabilization timeout before launcher rollback. |
└ updates.android | map | optional | Android companion APK update targets for first-party update orchestration. | |
└ updates.android.auto | bool | optional | false | Enable configured Android companion APK updates during update orchestration. |
└ updates.android.package | string | optional | com.cacophony.companion | Android package name to inspect/install. |
└ updates.android.artifact | string | optional | cacophony-companion.apk | GitHub release APK asset name. |
└ updates.android.targets | list[map] | optional | Explicit adb update targets. | |
└ updates.android.targets.name | string | optional | Optional target name. | |
└ updates.android.targets.host_node | string | optional | Node that owns adb connectivity; omitted means local node. | |
└ updates.android.targets.serial | string | required | adb serial such as sgu24:5555. | |
└ updates.android.targets.enabled | bool | optional | true | Whether this target participates in update checks/installs. |