Files
fleet/articles/how-to-uninstall-fleetd.md
T
Noah TalermanandSteven Palmesano 96ca0fd967 Fix unenroll Windows instructions (#47725)
- @noahtalerman: For Windows, I think we want to squeeze turning off MDM
and uninstalling fleetd into one script.
- Why? Because Fleet automatically turns on Windows MDM, two scripts
means Fleet could beat the IT admin and turn MDM back on before they
uninstall fleetd.


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Windows fleetd uninstall now proactively detects and disables MDM
enrollment before removal to help ensure a cleaner device unenrollment.
* **Bug Fixes**
* Improved uninstall error reporting by surfacing the underlying failure
message and exiting with a clear non-zero code.
* **Chores**
* Updated fleet testing and workstation configurations: removed the
Windows uninstall/MDM-related steps from QA and workstation controls,
and added new Windows security/setup scripts plus additional
cross-platform post-install and extension installation tasks.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Steven Palmesano <3100993+spalmesano0@users.noreply.github.com>
2026-06-19 13:15:00 -04:00

2.9 KiB

How to uninstall Fleet's agent (fleetd)

You can uninstall fleetd directly on a device or remotely through Fleet.

Uninstall fleetd on macOS

To remove fleetd from a Mac:

  1. Download the macOS uninstall script.
  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

Uninstall fleetd on Windows

To remove fleetd from a Windows device:

  1. Download the Windows uninstall script. This script turns off MDM and uninstalls fleetd.
  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. 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.
  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, Windows, or Linux 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.