Agent configuration: How to upgrade from below 1.38.1 (#41593)

For the following bug:
- https://github.com/fleetdm/fleet/issues/41169
This commit is contained in:
Noah Talerman
2026-03-18 18:00:01 -05:00
committed by GitHub
parent ded761c391
commit d6857b6a4b
@@ -201,6 +201,8 @@ _Available in Fleet Premium_
Users can configure fleetd component TUF [auto-update channels](https://fleetdm.com/docs/using-fleet/enroll-hosts#specifying-update-channels) from Fleet's agent options. The components that can be configured are `orbit`, `osqueryd` and `desktop` (Fleet Desktop). When one of these components is omitted in `update_channels` then `stable` is assumed as the value for such component.
> Because Fleet moved the update server from tuf.fleetctl.com to updates.fleetdm.com, Orbit versions below 1.38.1 cant upgrade directly to newer versions. Youll see this error in Orbit logs: `update failed error="lookup failed: lookup orbit: tuf: file not found`. To upgrade from a version below 1.38.1 (e.g., 1.29.1) to a newer version (e.g., 1.50.2), first upgrade to 1.38.1, wait for agents to update, then upgrade to the newer version.
#### Examples
```yaml