Discharge7443/fleet
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity

Update rollback instructions for app versions (#49729)

Browse Source 
Clarify rollback steps and update section title.

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
This commit is contained in:
Marko Lisica
2026-07-23 20:36:19 +02:00
committed by GitHub
co-authored by Noah Talerman
parent f72de68f43
commit 375a03e065
1 changed files with 13 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
articles/fleet-maintained-apps.md
+13 -3
View File
@@ -89,11 +89,21 @@ Use a caret (`^`) constraint to pin to a major version (for example, `"^147"`).
You can also pin via the REST API using the `version` parameter on the [`PATCH /api/v1/fleet/software/titles/:id/package`](https://fleetdm.com/docs/rest-api/rest-api#update-package) endpoint.
## Roll back to a previous version
## Rollback to a previous version
If a new version introduces a bug, roll back by pinning the app to the previous version using the same **Actions > Versions** workflow (or the GitOps `version` key or REST API above).
> Installing an older version of an app on top of a newer version might cause issues for some apps. The best practice is to test this on a test device first.
> Hosts already running the newer version will downgrade to the pinned version the next time the app is installed.
Sometimes, end users report that the latest version of an app introcduces buggy behavior that prevents them from getting their work done. If this happens, you can rollback the app to the older version:
1. Pin the app to the older version. [Learn how](#pin-a-version).
2. If you use [patch policy](https://fleetdm.com/guides/how-to-use-policies-for-patch-management-in-fleet) to keep your app up to date, delete the policy.
3. Create a new, custom policy (Zoom example below) that fails if a host has the version with the buggy behavior and add a software automation to install the older version.
```sql
SELECT 1 WHERE NOT EXISTS (
SELECT 1 FROM programs WHERE name = 'Zoom' AND version = '<version_with_bug>'
);
```
## Keep apps up to date with patch policies