Getting Started

The best way to get started with S.U.P.E.R.M.A.N. (or just super) is to test it locally via command line. This allows you to try different super options and view the super.log feedback in real time.

Testing super Locally

1. Download the main version super from here, or a potentially newer version from the releases page.
2. Give the downloaded super script file the appropriate execute permissions: sudo chmod a+x ~/Downloads/super
3. super must run with root permissions, and the test mode is enabled with the --test-mode option:
   sudo ~/Downloads/super --test-mode
4. The super script automatically installs itself (and various other accoutrements) anytime it's ran from outside its working folder /Library/Management/super/.
5. After super installs itself, it automatically restarts in test mode and after a few moments a test "Restart or Defer" dialog should appear.
6. Clicking "Restart" button does not restart your computer, but it does show the additional dialogs or notifications as it would appear to the user if a real macOS update was going to be installed.
7. Once installed, you can use super like any other built-in command line tool. To test the workflow again or try other options, simply start with sudo super in the Terminal.

Getting Started

Getting Started Tips

• When super runs it maintains a settings file similar to a regular application. For example, you only need to use the --test-mode option once. After that, every time you run super it remains in test mode until you disable it via the --test-mode-off option.

• You can continue to use super in test mode to experiment with all the other options without actually applying any software updates. Even though software updates are simulated, all other options (including authentication options) behave as they would in production.

• You can list all possible super options by using the super --usage option. You can also open your default browser to this super wiki by using the super --help option.

• The default super (and test mode) workflow only attempts macOS minor updates. Check out the full test mode documentation to try other workflows.

• If you want to uninstall super you can do so via the Remove-super.sh script in the Super-Friends folder.