fleet/articles/how-to-uninstall-fleetd.md
kitzy 6f632da279
Update uninstall documentation for fleetd (#36565)
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>
2025-12-05 06:09:42 -05: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.
  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.