Macjutsu/super v5.1.0-rc1

on GitHub

[5.1.0-rc1]

2025-10-02

Highlights (5.1.x)

• Suport for macOS 26 Tahoe.
• New ability to target specific macOS versions (ex. 15.6.1) for both minor updates and major upgrades.
• Completely rearchitected super preferences mechanism allows for alternate configuration workflows. In other words, you can now create multiple different super workflow configurations and active them on an as-needed basis.
• Significantly improved macOS minor update workflow is fully compatible on systems with all built-in automatic software update options enabled.
• New scheduling options for automatic deferrals when provisioning new systems and when you want to delay the start of a workflow after zero day.
• New workflow options for installing non-system software updates.
• Significant quality of life improvements for gathering information about the super workflow configuration including a new super-audit.log.

Highlights (5.0.x)

• Suport for macOS 15 Sequoia.
• New scheduled installation workflows allow administrators or the end user to specify a date and time for the installation of macOS updates/upgrades, Jamf Pro Policies, or enforced system restarts.
• New schedule workflow active option allows administrators to set exactly when the super workflow is active, thus allowing for "maintenance windows".
• MacAdmin's SOFA integration allows schedule and deadline options to align with macOS release dates (as opposed to when super discovers a macOS release).
• Completely rearchitected main super logic so all workflow options can be permanent (via configuration profile) or temporary until the requested workflow is completed.
• Completely rearchitected software update/upgrade discovery to significantly improve reliability, performance, and improve support for native macOS software update restrictions deferral.
• Significantly improved behavior for alternate workflow targets (non-system updates, Jamf Pro Policies, and enforced system restarts) now support all deferral, schedule, deadline, and display options.
• Even more user interface customization options.
• Please visit the super Wiki for full details!

Compatibility Notes (5.x)

• super 5.x requires macOS 11 or newer.
• Several super 4.x command line options and managed preferences are not compatible with super 5.x
• Most super 3.0 command line options and managed preferences are not compatible with super 5.x
• Previously saved super 3.0 and 4.x Apple silicon authentication credentials are automatically migrated the first time super 5.x runs.
• Refer to this spreadsheet (tab separated values) for migrating super command line options.
• Refer to this spreadsheet (tab separated values) for migrating super managed preferences.
• Updated example MDM configuration profiles.
• Updated Jamf Pro External Application Custom Schema.
• Updated Jamf Pro Extension Attribute scripts.

Known Issues (5.x)

• The super workflow does not currently support declarative software update settings. You should continue to use traditional configuration profiles to enforce software update settings.
• There are currently no available Rapid Security Response (RSR) updates for any version of macOS. As such, RSR update workflows have not been validated against this version of super.
• The Jamf Pro new Managed Software Updates feature remains unreliable if the workflow target is not the latest minor update or major upgrade. In the mean time, the legacy Jamf Pro software update API remains stable (although deprecated) and local authentication is always the most reliable.

Specific Changes (5.1.0-rc1)

• New support for macOS 26 Tahoe.

• New --install-macos-minor-version-target=macOSVersionNumber option allows you to target specific macOS minor updates (for example, 15.6.1). Note that targeting specific minor updates that are not the latest version is very likely to require full macOS installer downloads.

• Significantly updated --install-macos-major-version-target=macOSVersionNumber option allows you to target specific macOS major upgrades (for example, 15.6.1). Note that targeting specific major upgrades that are not the latest version is very likely to require full macOS installer downloads.

• New <key>ConfigTempOverride</key> <true/> | <false/> managed preference key allows temporary alternate workflow settings (started via the --config-start-temp=ConfigurationName option) to override conflicting managed preferences.

• New mist-cli 2.2 (which now supports creating installers on macOS 15.6 and later) is automatically installed if required to facilitate macOS installer workflows. (Thanks to @ninxsoft for his dedication to the project!)

• Improved macOS installer validation now checks for matching target version and build number.

• Improved software status cache age verification now also allows for setting a specific age by adjusting the SOFTWARE_STATUS_CACHE_AGE_MINUTES parameter in the set_defaults() function.

• Improved Jamf Pro version tracking now accounts for full version numbers (ex. 11.20.1).

• Improved alternate workflow configuration logging.

• Resolved an issue that prevented saving changes to alternate workflow settings if there was a conflicting managed workflow setting.

• Resolved an issue that would cause workflow errors if duplicate non-system updates were discovered.

• Updated spreadsheet (tab separated values) for migrating to super v5.1.0 command line options.

• Updated spreadsheet (tab separated values) for migrating to super v5.1.0 managed preferences.

• Updated "Software Update Automatic Settings"example MDM configuration profile.

• Updated "Software Update Notification Settings" example MDM configuration profile.

• Updated "All Options" example MDM configuration profile.

• Updated "All Options" example MDM property list.

• As always, typo fixes and improvements to both regular and verbose log output.

• super 5.1.0-rc1 SHA-256: f28fab463885139970781cbe7aa83263f14b97a8246eb05a9ece0281fa6a10b9

Please refer to the Change log for full details.