diff --git a/articles/software-self-service.md b/articles/software-self-service.md index 19451d9581..a55cc45427 100644 --- a/articles/software-self-service.md +++ b/articles/software-self-service.md @@ -56,15 +56,14 @@ _Available in Fleet Premium_ End users can install every app in a category in one click from the **My device > Self-service** page: 1. Select a category from the dropdown above the software table. -2. Select **Install all (n)** to install every app in the category, or **Install missing (n)** to install only the apps that aren't yet installed. The button label and count adjusts based on what's already installed on the device. +2. Select **Install all** to install every app in the category. The count in the button adjusts based on what's already installed on the device. -Fleet queues each install as a separate operation; end users can monitor progress in the **Status** column. Software is installed in alphabetical order. +Fleet queues each install as a separate operation. End users can monitor progress in the **Status** column. Software is installed in alphabetical order. ## Deploy self-service on iOS and iPadOS Install this configuration profile to add the self-service web app to the home screen on iPhone and iPad. - ### Create the self-service configuration profile On your Mac, open [iMazing Profile Editor](https://imazing.com/profile-editor). Create a new profile and add a **Web Clip** payload with these settings: diff --git a/docs/Configuration/yaml-files.md b/docs/Configuration/yaml-files.md index 1142991b5e..98d93cc6bb 100644 --- a/docs/Configuration/yaml-files.md +++ b/docs/Configuration/yaml-files.md @@ -537,11 +537,6 @@ Currently, when a `.ipa` file is added in `packages`, Fleet adds software for bo ```yaml software: - self_service_categories: - - "🌎 Browsers" - - "👬 Communication" - - "🧰 Developer tools" - - "💻 Productivity" packages: - path: ../lib/software-name.package.yml categories: @@ -593,20 +588,13 @@ software: - Engineering ``` -#### self_service_categories - -_Available in Fleet Premium_ - -- `self_service_categories` is a list of custom self-service category names available on this fleet. End users can browse and install self-service software by category on the **My device > Self-service** page. Custom categories replace Fleet's previous fixed list and are managed per fleet. -- Each category name must be unique within the fleet (case-insensitive) and is limited to 255 characters. Emojis are supported and are part of the name (e.g. `"🌎 Browsers"`). -- When a fleet is created, Fleet seeds the following default categories that admins can rename or delete: **🌎 Browsers**, **👬 Communication**, **🧰 Developer tools**, **💻 Productivity**, **🔐 Security**, and **🛟 Support**. -- `self_service_categories` is an optional key. When the key is included, the listed categories fully replace the fleet's existing self-service categories — any category not listed is deleted. When the key is omitted, existing categories are left unchanged. Software assigned to a deleted category is removed from that category but otherwise unaffected. - #### self_service, labels, categories, and setup_experience - `self_service` specifies whether end users can install from **Fleet Desktop > Self-service** (default: `false`) on macOS or [self-service web app](https://fleetdm.com/learn-more-about/deploy-self-service-to-ios) on iOS/iPadOS. - `labels_include_all` targets hosts that **have all** of the specified labels. `labels_include_any` targets hosts that **have any** of the specified labels. `labels_exclude_any` targets hosts that **have none** of the specified labels. Only one of these fields can be set. If none are set, all hosts are targeted. -- `categories` is a list of [self-service category names](#self-service-categories) on the fleet. Categories group self-service software on your end users' **Fleet Desktop > My device** page so that end users can filter by category and install all software in a category at once. Each value must match a category defined in the fleet's `self_service_categories`. If `categories` is empty, Fleet-maintained apps get their [default categories](https://github.com/fleetdm/fleet/tree/main/ee/maintained-apps/outputs) (creating them on the fleet if needed) and all other software only appears in the **All** group. +- `categories` is a list of self-service category names. Categories group self-service software on your end users' **Fleet Desktop > My device** page so that end users can filter by category and install all software in a category at once. + - Category names support emojis and can be up to 255 characters long. The uniqueness checks ignore emojis, so `"🌎 Browsers"` and `"🔍 Browsers"` are treated as the same name. + - For Fleet-maintained apps, if `categories` is omitted, apps get their [default categories](https://github.com/fleetdm/fleet/tree/main/ee/maintained-apps/outputs). If `categories` is empty, default categories are removed. If custom categories are specified, apps don't get their default categories unless they're specified explicitly. - `setup_experience` installs the software when hosts enroll (default: `false`). Learn more in the [setup experience guide](https://fleetdm.com/guides/setup-experience). ### packages @@ -714,7 +702,7 @@ If the fields below are omitted, they default to values specified in [the app's - `install_script.path` specifies the command Fleet will run on hosts to install software. - `uninstall_script.path` is the script Fleet will run on hosts to uninstall software. -- `categories` is an array of categories, from [supported categories](#labels-and-categories). +- `categories` is an array of categories, see [categories](#self-service-labels-categories-and-setup-experience). ## org_settings and settings