From 375a03e065c55707e8b113ec5f63a99e67fdaea5 Mon Sep 17 00:00:00 2001 From: Marko Lisica <83164494+marko-lisica@users.noreply.github.com> Date: Thu, 23 Jul 2026 20:36:19 +0200 Subject: [PATCH] Update rollback instructions for app versions (#49729) Clarify rollback steps and update section title. --------- Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com> --- articles/fleet-maintained-apps.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/articles/fleet-maintained-apps.md b/articles/fleet-maintained-apps.md index 44beaca2a8..7b50da1802 100644 --- a/articles/fleet-maintained-apps.md +++ b/articles/fleet-maintained-apps.md @@ -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 = '' +); +``` ## Keep apps up to date with patch policies