Elgato_dark/fleet
1
0
Fork 0
mirror of https://github.com/fleetdm/fleet synced 2026-05-24 01:18:42 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 59
fleet/articles/fleet-desktop-on-fedora-and-debian.md
Eric 7ca5306edf
Website: update article image filenames to match website naming conventions (#32263) 
Related to: [#25943](https://github.com/fleetdm/fleet/issues/25943)

Changes:
- Updated filenames of images in the website/assets/images/articles/
folder to match website naming conventions
- Updated links to images in articles.
2025-08-25 12:47:33 -05:00

3.2 KiB
Raw Blame History

Enabling Fleet Desktop on Fedora and Debian

Fleet Desktop is a menu bar icon available on macOS, Windows, and Linux that gives your end users visibility into the security posture of their machine.

Fedora and Debian do not support tray icons by default and rely on the appindicator-support GNOME extension for enabling tray icons. GNOME extensions prompt the end user to accept the installation.

This article aims to explain how admins can enable Fleet Desktop on such Linux distributions by using policy queries paired with script execution.

Policy and script execution

The policy query defined in check-fleet-desktop-extension-fedora-debian.yml (from our Dogfood environment) checks if the extension needed for Fleet Desktop is installed and enabled on Fedora and Debian hosts.

NOTE: fleetd 1.41.0 is required (the policy query relies on a table added to that version).

Starting in version v4.58.0, Fleet supports running scripts to remediate failing policies (see the Automatically run scripts article for more information). Admins can therefore configure Fleet to run install-fleet-desktop-required-extension.sh on devices where the policy detects the extension is missing (check-fleet-desktop-extension-fedora-debian.yml contains both the policy and remediation script).

End-user experience

Following are screenshots of the end-user experience when Fleet runs the script to install the extension (GNOME requires a prompt for installation of extensions for security purposes).

If the end-user hits Cancel instead of Install then the extension won't be installed and the policy will continue to fail on the host. Fleet only deploys the script on the first failure of the policy, so the end-user won't be prompted again and again, just once. Admins can still run the script on such hosts manually.

Tray icon

After the extension is installed your users will see the Fleet icon on their menu bar: