Skip to content

Advanced Alternate Configuration

Kevin edited this page Oct 8, 2025 · 1 revision

In addition to the main super settings file and MDM configuration profile, you can also create multiple alternate configurations that can start a variety of different workflows.

Edit The Main Configuration

Edit configuration settings in the main super preference file without starting the workflow.

Command option example:
--config-edit-main

Any other workflow options specified at the same time (or in the same command line) are added to the main /Library/Management/super/com.macjutsu.super.plist.

Create or Edit an Alternate Configuration

Create or edit configuration settings in alternate super preference file without starting the workflow.

Command option example:
--config-edit=ConfigurationName

Any other workflow options specified at the same time (or in the same command line) are added to an alterate preference file located at /Library/Management/super/configs/com.macjutsu.super.ConfigurationName.plist.

Clone or Edit an Alternate Configuration

Duplicate an existing alternate configuration.

Command option example:
--config-clone=SourceConfigurationName

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.

Delete an Alternate Configuration

Delete the specified alternate configuration.

Command option example:
--config-delete=ConfigurationName

Obviously, if the deleted configuration was being used for an active workflow, then that workflow is also stoped.

Delete All Alternate Configurations

Deletes all alternate configurations.

Command option example:
--config-delete-all

This removes all alternate configuration preferences in the /Library/Management/super/configs/ folder. Obviously, if the any of the deleted configurations were being used for an active workflow, then those workflows are also stoped.

Start a Default Alternate Configuration

Start the specified alternate configuration as the default super workflow.

Command option example:
--config-start-default=ConfigurationName

Command option disable example:
--config-start-default=X

Workflow settings in the default configuration take priority over the main super preferences. Additionally, settings that are only found in the main super preferences are also used in the workflow.

Start a Temporary Configuration

Start the specified alternate configuration as a temporary super workflow.

Command option example:
--config-start-temp=ConfigurationName

Command option disable example:
--config-start-temp=X

Workflow settings in the temporary configuration take priority over BOTH the default configuration and the main super preferences. However, once the workflow defined by the temporary configuration has completed, super returns to the default configuration or the main super preferences (if there is no alternate default configuration). Additionally, settings that are only found in the main super preferences are also used in the workflow.

Allow Temporary Configuration Override

Allow temporary alternate workflow settings (started via the --config-start-temp=ConfigurationName option) to also override conflicting managed preferences.

Configuration profile example:
<key>ConfigTempOverride</key>
<true/>

This option can ONLY be specified in a super MDM configuration profile.

View super Configuration Status

Returns the status of a variety of items including the contents of the super folder, super settings files, and software update history.

Command option examples:
--config-status

While this option does require root permissions, it does not start or interrupt the super workflow.

In addition to information about the super workflow configuration, output from this command also includes the installation history of macOS system and security updates. The installation history is generated by parsing output from the system_profiler command, so this includes all macOS installations, not just those completed by super.

Clone this wiki locally