Uninstall fleetd (#29202)

Local instructions
This commit is contained in:
Noah Talerman 2025-05-16 10:22:52 -04:00 committed by GitHub
parent 157a153c31
commit 3a7c45ca35
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -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).
<meta name="category" value="guides">