From 3a7c45ca351c858a0527c3f3938c68ff6de9366c Mon Sep 17 00:00:00 2001 From: Noah Talerman <47070608+noahtalerman@users.noreply.github.com> Date: Fri, 16 May 2025 10:22:52 -0400 Subject: [PATCH] Uninstall fleetd (#29202) Local instructions --- articles/how-to-uninstall-fleetd.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/articles/how-to-uninstall-fleetd.md b/articles/how-to-uninstall-fleetd.md index 05c8b399c2..bfb5381085 100644 --- a/articles/how-to-uninstall-fleetd.md +++ b/articles/how-to-uninstall-fleetd.md @@ -1,11 +1,23 @@ # How to uninstall Fleet's agent (fleetd) -This guide walks you through the steps to remove fleetd from your device. After performing these steps, the device will display as an offline host in the Fleet UI until you delete it. +How to remove fleetd from your device: + +1. Download the uninstall script for [macOS](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/macos/scripts/uninstall-fleetd-macos.sh), [Windows](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/windows/scripts/uninstall-fleetd-windows.ps1), or [Linux](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/linux/scripts/uninstall-fleetd-linux.sh). + +2. Run the script. +- To run the script on macOS, open the **Terminal** app. +- Navigate to the script's directory by running this command: `cd /path/to/your/script` +- Make the script executable: `chmod +x uninstall-fleetd-macos.sh` +- Run it: `sudo ./uninstall-fleetd-macos.sh` + +How to uninstall fleetd from a host via Fleet (remotely): 1. Add the uninstall script for [macOS](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/macos/scripts/uninstall-fleetd-macos.sh), [Windows](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/windows/scripts/uninstall-fleetd-windows.ps1), or [Linux](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/linux/scripts/uninstall-fleetd-linux.sh) hosts to Fleet. 2. Head to the host's **Host details** page and select **Actions > Run script** to run the script. +After performing these steps, the host will display as an offline host in the Fleet UI until you delete it. + Are you having trouble uninstalling Fleetd on macOS, Windows, or Linux? Get help [here](https://fleetdm.com/slack).