Elgato_dark/fleet
1
0
Fork 0
mirror of https://github.com/fleetdm/fleet synced 2026-04-21 13:37:30 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 91

Update uninstall documentation for fleetd (#36565)

Browse source 
Update the uninstall documentation for fleetd by providing detailed
steps for macOS, Windows, and Linux.

---------

Co-authored-by: Graham Williams <gray@live.co.uk>
Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
This commit is contained in:
kitzy 2025-12-05 06:09:42 -05:00 committed by GitHub
parent d8e25196ff
commit 6f632da279
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 41 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

53
articles/how-to-uninstall-fleetd.md
View file

@ -1,24 +1,53 @@
# How to uninstall Fleet's agent (fleetd)
How to remove fleetd from your device:
You can uninstall fleetd directly on a device or remotely through Fleet.
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`
## Uninstall fleetd on macOS
How to uninstall fleetd from a host via Fleet (remotely):
To remove fleetd from a Mac:
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.
1. Download the [macOS uninstall script](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/macos/scripts/uninstall-fleetd-macos.sh).
2. Open the **Terminal** app.
3. Navigate to where you saved the script: `cd /path/to/your/script`
4. Make the script executable: `chmod +x uninstall-fleetd-macos.sh`
5. Run the script: `sudo ./uninstall-fleetd-macos.sh`
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.
## Uninstall fleetd on Windows
Are you having trouble uninstalling Fleetd on macOS, Windows, or Linux? Get help via one of our [support channels](https://fleetdm.com/support).
To remove fleetd from a Windows device:
1. Download the [Windows uninstall script](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/windows/scripts/uninstall-fleetd-windows.ps1).
2. Open **PowerShell** as administrator (right-click and select **Run as administrator**).
3. Navigate to where you saved the script: `cd C:\path\to\your\script`
4. Run the script: `.\uninstall-fleetd-windows.ps1`
> Note: When running unsigned PowerShell scripts, you are likely to receive a warning, and will need to adjust the [Execution Policy](https://learn.microsoft.com/en-gb/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.5). One example is: `Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process`. This will bypass all warnings and prompts for the current PowerShell session.
## Uninstall fleetd on Linux
To remove fleetd from a Linux device:
1. Download the [Linux uninstall script](https://github.com/fleetdm/fleet/blob/main/it-and-security/lib/linux/scripts/uninstall-fleetd-linux.sh).
2. Open your terminal.
3. Navigate to where you saved the script: `cd /path/to/your/script`
4. Make the script executable: `chmod +x uninstall-fleetd-linux.sh`
5. Run the script: `sudo ./uninstall-fleetd-linux.sh`
## Uninstall fleetd remotely
To remove fleetd from a device through Fleet:
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) to Fleet as a script.
2. Go to the device's **Host details** page.
3. Select **Actions > Run script** and choose the uninstall script.
After uninstalling, the device will show as offline in Fleet until you delete it.
Need help? Contact us through one of our [support channels](https://fleetdm.com/support).
<meta name="category" value="guides">
<meta name="authorFullName" value="Eric Shaw">