v5.1.0-beta5

[5.1.0-beta5]

2025-07-10

Highlights (5.1.x)

• 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 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.
• New Jamf Pro Extension Attribute scripts for features unique to super 5.x.
• Several updated Jamf Pro Extension Attribute scripts now supports super versions 3.0, 4.x, and 5.x.
• Updated example MDM configuration profiles.
• Updated Jamf Pro External Application Custom Schema.

Known Issues (5.x)

• The super workflow has not been tested on systems with 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-beta5)

• New --config-clone=SourceConfigurationName option duplicates an existing alternate configuration preference file. This option must be used with the --config-edit=ConfigurationName option to specify (a new or existing) destination for the copy of the cloned configuration. Any additional options specified in the same run are also applied to the destination configuration.
• New configuration preference file attribute ConfigEditTimestamp is the date and time of the previous edits made to that configuration file from a previous super run.
• Significantly improved download workflow assumes that macOS minor updates should be downloaded by the built-in automatic software update option. Workflows targeting macOS minor updates automatically defer if the update has not yet downloaded and the system is configured to automatically download macOS updates.
• Improved --config-status option now shows if a macOS update or upgrade has been cached (downloaded and prepared) by the softwareupdate service.
• Resolved an issue when using a --config-edit* option that would improperly exit the super workflow.
• Resolved an issue when using a --config-edit* option that would improperly disable the super workflow from automatically re-launching.
• Updated spreadsheet (tab separated values) for migrating to super v5.1.0 command line options.
• As always, typo fixes and improvements to both regular and verbose log output.
• super 5.1.0-beta5 SHA-256: 1ef92bbcb757037d6cc5c904bb91aad80df1b10ef364201160ff5bebbcd0ed8d

Please refer to the Change log for full details.

v5.0.0

[5.0.0]

2024-10-17

Highlights (5.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.
• New Jamf Pro Extension Attribute scripts for features unique to super 5.x.
• Several updated Jamf Pro Extension Attribute scripts now supports super versions 3.0, 4.x, and 5.x.
• Updated example MDM configuration profiles.
• Updated Jamf Pro External Application Custom Schema. (Huge thanks to @tonyyo11 for taking this on!)

Known Issues (5.0.0)

• 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.

Please refer to the Change log for full details.

v4.0.3

2023-12-14

Highlights

• New option to save the user's password for future automatic macOS updates and upgrades. Literally, "Save Password" but for automatic macOS updates and upgrades.
• New display customization options including unmovable dialogs and hide background mode courtesy of IBM Notifier 3.x.
• New macOS installer workflows are now handled by mist-cli integration, thus removing all python dependencies.
• New LaunchDaemon architecture significantly improves automatic launch and deferment reliability for all super workflows.
• New default "always on" behavior automatically checks for Apple software updates on a regular basis.
• Support for Jamf Pro 10.48+ (Beta) Managed Software Updates.
• Support for Jamf Pro 10.49+ API Roles and Clients.
• Please check out the updated super Wiki for more details!

Compatibility Notes

• super 4.x requires macOS 11 or newer (all code supporting macOS 10.x has been removed).
• All super 4.x code has been refactored for style, clarity, and uniformity. As such nearly every single option name has been changed.
• Most super 3.0 command line options and managed preferences are not compatible with super 4.x
• Previously saved super 3.0 Apple silicon authentication credentials are automatically migrated the first time super 4.x runs.
• It is safe to mix super version 3.0 and 4.x managed preferences (except for the DisplaySilently key) in a single configuration profile. However each version only recognizes the managed preference keys that are compatible for that version.
• Refer to this spreadsheet (tab separated values) for migrating super 3.0 command line options to version 4.x.
• Refer to this spreadsheet (tab separated values) for migrating super 3.0 managed preferences to version 4.x.
• Updated Jamf Pro Extension Attribute scripts now supports both super versions 3.0 and 4.x.
• Updated example MDM configuration profiles for super v4.x.
• super 4.0.3 SHA-256: 2c7411a4bfa84a63e20955d18d6c6ba19933b2cf35b04f91bbcac98c666e335c

Known Issues

• The Jamf Pro (Beta) Managed Software Updates workflow is not compatible with the --install-macos-major-version-target option. Until this issue is resolved you can revert your Jamf Pro service back to the current macOS software update workflow.

Please refer to the Change log for full details.

v3.0

• Support for both macOS updates and upgrades.
• Support for macOS Rapid Security Response updates.
• New dialog customization options including; new help and warning buttons, embedded text, embedded images, and even embedded video.
• New user self-servicing workflows with progressive status notifications.
• New Apple silicon user authenticated workflows feature all customizable dialogs (built-in software update interfaces can be entirely avoided).
• New required free storage space and battery charge level detections with customizable notifications.
• Significantly improved error detections automatically try failed workflows again later.
• Vastly improved logging to help you identify specific workflow issues.
• An array of new helper items in the Super-Friends folder to further improve your workflows.
• Even more features and options are documented in the S.U.P.E.R.M.A.N. Wiki.
• Detailed super version progress can be found in the Change Log.
• You can also join the conversation at the Mac Admins Foundation Slack in channel #super.
• super 3.0 SHA-256: ac297dd3f5496a20648e35b73313ccddd8843a75cc95c9dadb9d900a60b8edd8

v2.0

• Version 2.0 is the final release for super version 2. See the [CHANGELOG.md]
• The S.U.P.E.R.M.A.N. Wiki is finally helpful!
• Detailed help removed from within the super script, because...
• If there is a current GUI user the --help option now automatically opens the S.U.P.E.R.M.A.N. Wiki. If there is no current GUI user this option shows basic usage.
• Spellcheck! So. Many. Typos.

v1.1

• Version 1.1 is the final release for super version 1. See the CHANGELOG.md for full details.
• Stay tuned for super version 2 that will offer even more deferment options!