|
| 1 | +# Fleet-maintained apps |
| 2 | + |
| 3 | +_Available in Fleet Premium_ |
| 4 | + |
| 5 | +In Fleet, you can install Fleet-maintained apps on macOS and Windows hosts without the need for manual uploads or extra configuration. This simplifies the process and adds another source of applications for your fleet. |
| 6 | + |
| 7 | +Fleet maintains installation metadata for [a number of apps](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/apps.json), letting you add them to your own Fleet instance and install them on your hosts without any additional configuration. |
| 8 | + |
| 9 | +## Important notes on CPU architecture |
| 10 | + |
| 11 | +### macOS |
| 12 | + |
| 13 | +Currently, the macOS versions of these apps are Apple Silicon-only rather than universal: |
| 14 | + |
| 15 | +* 1Password |
| 16 | +* Brave |
| 17 | +* Docker Desktop |
| 18 | +* Figma |
| 19 | +* Microsoft Visual Studio (VS) Code, |
| 20 | +* Notion |
| 21 | +* Postman |
| 22 | +* Slack |
| 23 | +* Zoom |
| 24 | + |
| 25 | +### Windows |
| 26 | + |
| 27 | +Fleet prefers 64-bit x86 versions of applications when available. Installing on Arm hosts (e.g. in a VM on an Apple Silicon machine) may not work or have other unintended consequences. |
| 28 | + |
| 29 | +## Add a Fleet-maintained app |
| 30 | + |
| 31 | +1. Head to the **Software** page for a team, then click **Add software**. You'll land on the Fleet-maintained apps list. |
| 32 | +2. Click the **Add** button for the app and platform you wish to add. |
| 33 | + |
| 34 | +> You'll see a ✅ icon instead of an **Add** button if the application has already been added to your team as a custom package or VPP app, or if you've already added the Fleet-maintained app. |
| 35 | +
|
| 36 | +3. Click **Add software** to download the installer package from the app's publisher into Fleet and make it available for install for your selected team. |
| 37 | + |
| 38 | +Fleet verifies install and uninstall scripts for each maintained app, and keeps the scripts up to date as an app's vendor releases new versions. You can override Fleet's scripts, or add pre-install queries or post-install scripts, either when adding the app (by clicking **Advanced options**) or later on (by editing the package). |
| 39 | + |
| 40 | +## Install the app |
| 41 | + |
| 42 | +You can install a Fleet-maintained app three ways: |
| 43 | + |
| 44 | +1. Manually in the **Host Details** page under the **Software** tab. Select the app you just added and choose **Install** from the **Actions** dropdown. |
| 45 | +2. Manually from the **Self-service** tab on the **My Device** page from an end user's machine, if you've [enabled Self-service](https://fleetdm.com/guides/software-self-service) for the app. |
| 46 | +3. Automatically on hosts via [policy automations](https://fleetdm.com/guides/automatic-software-install-in-fleet). |
| 47 | + |
| 48 | +You can track the installation process in the **Activities** section on the **Details** tab of this **Host Details** page. |
| 49 | + |
| 50 | +## Uninstall the app |
| 51 | + |
| 52 | +To remove the app, navigate to the **Host Details** page for the appropriate host, then to the **Software** tab. Find the app, then click on the **Actions** drop-down, then **Uninstall**. |
| 53 | + |
| 54 | +The uninstallation process is also visible in the **Activities** section on the **Details** tab of this **Host Details** page. |
| 55 | + |
| 56 | +## Update the app |
| 57 | + |
| 58 | +To get the latest version of a Fleet-maintained app, |
| 59 | + |
| 60 | +1. Remove the app from the team. |
| 61 | +2. Re-add it from the Fleet-maintained list on the **Software** page. |
| 62 | +3. Install the new version of the app via one of the three methods above. |
| 63 | + |
| 64 | +A streamlined flow for pulling the latest version of a Fleet-maintained app is [coming soon](https://github.com/fleetdm/fleet/issues/25636). |
| 65 | + |
| 66 | +## How does Fleet maintain these apps? |
| 67 | + |
| 68 | +Fleet: |
| 69 | + |
| 70 | +- verifies, installs, uninstalls & tests all Fleet-maintained apps alongside the install and uninstall scripts we generate |
| 71 | +- transforms data from multiple sources, including [Homebrew Casks](https://github.com/Homebrew/homebrew-cask) and [WinGet manifests](https://github.com/microsoft/winget-pkgs/tree/master/manifests), into [standardized manifests](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/), checking data sources [multiple times per day](https://github.com/fleetdm/fleet/blob/main/.github/workflows/ingest-maintained-apps.yml) |
| 72 | +- fetches the [full maintained apps list](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/apps.json) from GitHub daily (or when you run `fleetctl trigger --name=maintained_apps`) |
| 73 | +- fetches an individual app's manifest when the **Add** button is pressed from the maintained apps list in the UI, and when an individual app is [retrieved](https://fleetdm.com/docs/rest-api/rest-api#get-fleet-maintained-app) or [added](https://fleetdm.com/docs/rest-api/rest-api#add-fleet-maintained-app) via the REST API |
| 74 | +- DOES NOT directly pull data from WinGet or Homebrew to end-user devices |
| 75 | + |
| 76 | +<meta name="category" value="guides"> |
| 77 | +<meta name="authorFullName" value="Gabriel Hernandez"> |
| 78 | +<meta name="authorGitHubUsername" value="ghernandez345"> |
| 79 | +<meta name="publishedOn" value="2025-04-03"> |
| 80 | +<meta name="articleTitle" value="Fleet-maintained apps"> |
0 commit comments