Skip to content

Block macOS Monterey installer app from launching on macOS Big Sur or Catalina.

License

Notifications You must be signed in to change notification settings

seanism/montereyblocker

 
 

Repository files navigation

Monterey Blocker

Detect when Install macOS Monterey.app installer application has launched, terminate the process and display an alert.

montereyblocker

This project is totally copied from the original bigsurblocker from which it is forked from.

To fully uninstall montereyblocker, run the following (as root or with sudo), or deploy montereyblocker-remove.sh:

current_user_uid=$( echo "show State:/Users/ConsoleUser" | scutil | awk '/UID :/ && ! /loginwindow/ { print $3 }' )

launchd_item_path="/Library/LaunchAgents/dk.envo-it.montereyblocker.plist"
launchctl bootout gui/${current_user_uid} "${launchd_item_path}"

rm -f /Library/LaunchAgents/dk.envo-it.montereyblocker.plist
rm -f /usr/local/bin/montereyblocker

pkgutil --forget dk.envo-it.montereyblocker

See hjuutilainen/bigsurblocker for the original software for blocking Big Sur and README there.

The rest of this README is from that original project:

This project is heavily inspired by Erik Berglund's AppBlocker. It uses the same underlying idea of registering and listening for NSWorkspace notifications when app has started up and then checking the CFBundleIdentifier of the launched app to identify a Big Sur installer launch.

Why

Apple wants end users to upgrade to the latest macOS as soon as it becomes available. Depending on the software and policies your organization uses, this might be unacceptable. As an administrator, you currently have some options:

  • Use an MDM to push a profile to delay updates for maximum of 90 days. This will however postpone all updates, not just the macOS upgrade.
  • If your fleet is enrolled in an MDM, you can use softwareupdate --ignore to hide certain updates. This will result in a highly broken user experience where the system thinks it has an update pending but it is unable to download and install it. Apple has also decided that only MDM enrolled systems can use the --ignore flag.
  • If you are already using a binary authorization system such as Googles Santa, you should use it but deploying a system like Santa only for blocking Big Sur might be unfeasible.

How

The bigsurblocker binary is installed in /usr/local/bin and is launched for each user through a launch agent. This means that the binary is running in the user session and therefore has the privileges of the current user. It runs silently in the background and listens for app launch notifications. As soon as the user launches the macOS installer application, the binary (forcefully) terminates it and displays a warning message.

By design, it will not block the startosinstall command line tool.

Requirements

The binary requires at least macOS 10.9, however it has been tested only on macOS 10.10, 10.11, 10.12, 10.13, 10.14 and 10.15.

Note. It seems that macOS 10.10 and 10.11 have trouble installing a signed and notarized package. Use the unsigned package available from the releases page if deploying on those. The signed and notarized package can be used on macOS 10.12 and later.

Configuration

All configuration is optional. If needed, the alert title and text can be set through a configuration profile. Use com.hjuutilainen.bigsurblocker as the domain and AlertTitle and AlertText as the keys.

Installation

On macOS 10.12 and later, download a prebuilt package from the Releases page and deploy with your favorite method. The package is signed and notarized.

On OS X 10.11 and earlier, download and deploy an unsigned package from the Releases page and deploy with your favorite method

Uninstall

To fully uninstall bigsurblocker, run the following (as root or with sudo):

current_user_uid=$( echo "show State:/Users/ConsoleUser" | scutil | awk '/UID :/ && ! /loginwindow/ { print $3 }' )

launchd_item_path="/Library/LaunchAgents/com.hjuutilainen.bigsurblocker.plist"
launchctl bootout gui/${current_user_uid} "${launchd_item_path}"

rm -f /Library/LaunchAgents/com.hjuutilainen.bigsurblocker.plist
rm -f /usr/local/bin/bigsurblocker

pkgutil --forget com.hjuutilainen.bigsurblocker

License

Big Sur Blocker is licensed under the MIT License.

About

Block macOS Monterey installer app from launching on macOS Big Sur or Catalina.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 87.3%
  • Shell 12.7%