Skip to content

Conversation

@marko-lisica
Copy link
Member

Added 'automatic_updates' field to documentation for fleet_maintained_apps.
@marko-lisica marko-lisica changed the title Document automatic_updates field for fleet_maintained_apps [YAML] Pin Fleet-maintained apps to a specific version Nov 19, 2025
@marko-lisica marko-lisica marked this pull request as ready for review November 19, 2025 16:02
- `pre_install_query.path` is the osquery query Fleet runs before installing the software. Software will be installed only if the [query returns results](https://fleetdm.com/tables).
- `post_install_script.path` is the script that, if supplied, Fleet will run on hosts after the software installs.
- `icon.path` is a relative path to the PNG icon that will be displayed in Fleet and on **Fleet Desktop > Self-service** instead of the default icon the icon sourced from Apple. It must be a square PNG with dimensions between 120x120 px and 1024x1024 px. Custom icons will only override the icon for the software title and team where they are added.
- `pin_version` specifies the version of the package that will be downloaded by Fleet. Version can be set only to the version that is available in [the app's metadata on GitHub](https://github.com/fleetdm/fleet/tree/main/ee/maintained-apps/outputs). If version isn't specified, Fleet downloads the latest version as soon as it's available in the app's metadata.
Copy link
Member Author

@marko-lisica marko-lisica Nov 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dev note


  • If the user specifies a version that is not the current version, not available here in Fleet's repo, show following error:
1 error occured: Couldn't edit "<file_name>" at "<full_path>": specified version is not available. Find available versions: https://fleetdm.com/learn-more-about/available-fma-versions

See this PR for error format: PR link

@rachaelshaw rachaelshaw merged commit e5c9172 into docs-v4.79.0 Nov 20, 2025
6 checks passed
@rachaelshaw rachaelshaw deleted the 31919-yaml-changes branch November 20, 2025 17:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants