Skip to content

Releases: munki/munki

Munki 6.5.1 Official Release

22 May 15:16
Compare
Choose a tag to compare

This is the official release of Munki 6.5.1: a bug-fix release of the Munki tools.

Changes

  • A fix for a bug that prevented the new application data in conditional expressions feature from actually working as intended. (fbe22d2)
    See Conditional Application Data for more info on this feature, introduced (but due to the bug, effectively non-functional) in Munki 6.5: (bf1ce5a)
    Thanks to Tyler Gunderson for the bug report.

A complete list of changes from the 6.5.0 release is here: v6.5.0...v6.5.1

Known issues

Downgrading from 6.5.x to 6.4.2 or earlier

If you install a version of the Munki tools that contains the Python 3.12 framework, and then later attempt to downgrade by installing an older version of the Munki tools (say, 6.4.2.4634) that contains a Python 3.10 (or earlier) framework, /usr/local/munki/munki-python will be broken. See https://github.com/munki/munki/wiki/Downgrading-Munki-tools for more information.

Additional Information

Build info

The GUI apps and the Python framework were built under Xcode 15.3 on macOS 14.5. Xcode 14.3.1 on macOS 13 should work as well. Other versions of Xcode have not been tested and may cause different results. (Due to Apple bugs, Xcode 15.0.1 or Xcode 15 on macOS Sonoma will result in GUI apps that won't run on macOS < 10.15).

OS version support

This release should work on macOS 10.13 through macOS 14, though it gets little-to-no testing on versions prior to macOS 12. Please report issues you find with older macOS versions.

Package versioning

  • Distribution package version: 6.5.1.4661
  • munki core tools version: 6.5.1.4661
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.5.0.4654
  • Python package version: 3.12.2.4653

Attachment info

The munkitools-6.5.1.4661.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE (if you first sign the package). It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation.

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Munki 6.5.0 Official Release

23 Apr 15:16
Compare
Choose a tag to compare

This is the official release of Munki 6.5.0: a new feature release of the Munki tools.

This is the same build as beta 3: there have been no changes since that build.

Changes

  • Python changes (9e541a8)
    • Munki's included Python is now version 3.12.2
    • Certain added components have new versions:
      • cffi==1.16.0 (was 1.15.1)
      • pyobj-*==10.1 (was 9.1.1)
      • xattr==1.1.0 (was 0.10.1)
    • The imp module is no longer available in Python 3.12; this affected the import of middleware and repo plugins. The code has been updated to use importlib.util instead. (1850dbe)
  • Managed Software Center: a new progress spinner appears in the sidebar next to the "Updates" label when an update is in progress. (64cdd0f)
  • Source code: copyright dates updated
  • Information about currently installed applications is available for use in manifest conditional_items and pkginfo installable_conditions. See Conditional Application Data for more info. (bf1ce5a)
  • Updates to package pre- and postinstall scripts that call launchctl to use modern subcommands where possible. Drop support for pre-macOS 10.11 in these scripts. (bf91a80) (15de9ee)
  • Better handling of items with autoremove=True that also have a requires list and one or more required dependency cannot be resolved. (18ea6c4)
  • Better logging info when an item cannot be removed because other Munki items share the exact same packages (45b7ac6)
  • Workaround for unexpected content in /usr/sbin/installer due to new bundle-style package deprecation warnings (new in macOS 14.4) 29fd72a Thanks to @vmiller for reporting this issue.
  • manifestutil now has a delete-manifest subcommand: af4296d Thanks to @SteveKueng.
  • Improved debug messages when attempting to find a valid uninstall method for an item: c9e3250
  • Some changes to date/time handling so we have more explicit control of date-to-string and string-to-date conversions: aeac6e9

A complete list of changes from the 6.4.0 release is here: v6.4.2...v6.5.0

Known issues

Downgrading from 6.5 to an earlier version

If you install a version of the Munki tools that contains the Python 3.12 framework, and then later attempt to downgrade by installing an older version of the Munki tools (say, 6.4.2.4634) that contains a Python 3.10 (or earlier) framework, /usr/local/munki/munki-python will be broken. See https://github.com/munki/munki/wiki/Downgrading-Munki-tools for more information.

Additional Information

Build info

The GUI apps and the Python framework were built under Xcode 15.3 on macOS 14.4.1. Xcode 14.3.1 on macOS 13 should work as well. Other versions of Xcode have not been tested and may cause different results. (Due to Apple bugs, Xcode 15.0.1 or Xcode 15 on macOS Sonoma will result in GUI apps that won't run on macOS < 10.15).

OS version support

This release should work on macOS 10.13 through macOS 14, though it gets little-to-no testing on versions prior to macOS 12. Please report issues you find with older macOS versions.

Package versioning

  • Distribution package version: 6.5.0.4659
  • munki core tools version: 6.5.0.4659
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.5.0.4654
  • Python package version: 3.12.2.4653

Attachment info

The munkitools-6.5.0.4659.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE (if you first sign the package). It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation.

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Munki 6.4.2 Official Release

25 Jan 16:02
Compare
Choose a tag to compare

This is the official release of Munki 6.4.2: a bug-fix and minor feature release of the Munki tools.

Changes

  • New IgnoreMiddleware preference to ignore middleware by @patgmac in #1194. Useful if you are transitioning to/away from using middleware: you can turn it off (and possibly back on) without having to uninstall/reinstall the actual middleware.

Fixes

  • The new board-id and device-id conditional facts introduced in Munki 6.4 have been renamed board_id and device_id, respectively. It turns out the previous names are illegal in NSPredicate expressions and caused a client run to be terminated unexpectedly if used in conditional_items or installable_condition. Thanks to @mattydee99 for reporting this issue. (8edfc6a)
  • Handling of predicate expressions is now more careful to prevent a bad predicate from causing an unexpected termination. (dd74af6)

A complete list of changes from the 6.4.0 release is here: v6.4.1...v6.4.2

Build info

The GUI apps and the Python framework were built under Xcode 15.1 on macOS 14.3. Xcode 14.3.1 on macOS 13 should work as well. Other versions of Xcode have not been tested and may cause different results. (Due to Apple bugs, Xcode 15.0.1 or Xcode 15 on macOS Sonoma will result in GUI apps that won't run on macOS < 10.15).

OS version support

This release should work on macOS 10.13 through macOS 14, though it gets little-to-no testing on versions prior to macOS 12. Please report issues you find with older macOS versions.

Package versioning

  • Distribution package version: 6.4.2.4634
  • munki core tools version: 6.4.2.4634
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.4.0.4628
  • Python package version: 3.10.11.4623

Attachment info

The munkitools-6.4.2.4634.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE (if you first sign the package). It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation.

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Munki 6.4.1 Official Release

17 Jan 18:00
Compare
Choose a tag to compare

This is the official release of Munki 6.4.1: a bug-fix release of the Munki tools.

Fixes

  • Placement and appearance of the "back button" (which allows you to navigate back to the previous page in certain Managed Software Center views) has been tweaked to behave more like current macOS control behavior for tool bar items. (See #1195 for discussion)
  • Fix addressing #1083 -- Managed Software Center should no longer get stuck in a check loop, but rather stop and display an error when it cannot successfully retrieve the primary manifest.

A complete list of changes from the 6.4.0 release is here: v6.4.0...v6.4.1

Build info

The GUI apps and the Python framework were built under Xcode 15.1 on macOS 14.2.1. Xcode 14.3.1 on macOS 13 should work as well. Other versions of Xcode have not been tested and may cause different results. (Due to Apple bugs, Xcode 15.0.1 or Xcode 15 on macOS Sonoma will result in GUI apps that won't run on macOS < 10.15).

Package versioning

  • Distribution package version: 6.4.1.4630
  • munki core tools version: 6.4.1.4630
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.4.0.4628
  • Python package version: 3.10.11.4623

Attachment info

The munkitools-6.4.1.4630.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE (if you first sign the package). It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation.

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Munki 6.4 Official Release

02 Jan 16:15
Compare
Choose a tag to compare

This is the official release of Munki 6.4.0: a feature and bug-fix release of the Munki tools. This is the same build as 6.4.0 Beta 2.

Changes

  • 7dd42af - Some tweaks to "Aggressive Notification" behavior. Specifically, in earlier versions of Munki, Managed Software Center could display an "Aggressive Notification", but then if a background/periodic run of Munki happened while the "Aggressive Notification" was displayed, Managed Software Center would switch back into "non-aggressive" mode. This increased the likelihood that a user would not see the aggressive notification.
    In Munki 6.4.0, the "Aggressive Notification" mode is maintained while Munki is doing a background check. If after the check is complete, the Aggressive mode no longer applies, Managed Software Canter will then switch back to "non-aggressive" mode.
    Learn more about "Aggressive Notifications", a feature added in Munki 5, here: https://github.com/munki/munki/wiki/aggressive-update-notifications-in-munki-5
  • 4f8ba52 New built-in conditional "facts": board-id (for Intel Macs) and device-id (for Apple silicon Macs)
  • 350b92c c3846fd 150418f Experimental support for detecting the hardware support for a given macOS installer. The generated pkginfo will contain an installable_condition_disabled key containing a predicate to test for the detected supported hardware. If you choose to use this, rename the key to installable_condition. The predicate relies on the new support for board-id and device-id in the available conditional "facts", and so requires clients to be running Munki 6.4.0b2 or later.

Fixes

  • 35d24d1 - A fix for a display issue when running code/tools/make_munki_mpkg*.sh that looked like this (note the lack of YES/NO after "Include autorun pkg:"):
  Include bootstrap pkg: NO
  Include autorun pkg: 
  Include Rosetta2: NO
  Include config pkg: NO
  Include client cert pkg: NO

A complete list of changes from the 6.3.5 release is here: v6.3.5...v6.4.0

Build info

The GUI apps and the Python framework were built under Xcode 14.3.1 on macOS 13.6.1. Other versions of Xcode have not been tested and may cause different results. (Xcode 15.1 on macOS Sonoma should work; Xcode 15.0.1 or Xcode 15 on macOS Sonoma will result in GUI apps that won't run on macOS < 10.15).

Package versioning

  • Distribution package version: 6.4.0.4627
  • munki core tools version: 6.4.0.4627
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.3.0.4621
  • Python package version: 3.10.11.4623

Attachment info

The munkitools-6.4.0.4627.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE (if you first sign the package). It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation.

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Munki 6.3.5 Official Release

05 Dec 16:45
Compare
Choose a tag to compare

This is the official release of Munki 6.3.5, a bug-fix release of the Munki tools.

This is the same build as the 6.3.5b2 pre-release.

Fixes

  • managedsoftwareupdate:
    • A fix for an issue when one or more application items in an 'installs' list does not have a 'path' attribute and then gets used in a virtual 'blocking_applications' list: 6cf8c03
    • Better handling when an item that is a requirement for multiple other items fails to download: 9ba39af (See issues #1104 and #1188)
  • Managed Software Center:
    • Address an issue where Managed Software Center may not be brought frontmost or enter "aggressive notification mode" if it's already open in the background: 5c4e47a
    • Fix display issues in the "My Items" view in Managed Software Center when installing or removing an item: e92d538 (See issue #1189)
    • Address an issue in the munki 6.3.4 release where Managed Software Center.app crashes on launch on macOS < 10.15. This was caused by a bug in Xcode 15 and 15.0.1, and was addressed (for now) by building on macOS Ventura with Xcode 14.3.1.
  • makepkginfo/munkiimport:
    • Ensure generated pkginfo has 'uninstallable' set to True when an uninstall_method or uninstall_script is specified: 3b6aa21 (See issues #950 and #1160)
    • Fix for an issue when importing a bundle-style distribution package: 8134ced (See issue #1192)

A complete list of changes from the 6.3.4 release is here: v6.3.4...v6.3.5

Build info

The GUI apps and the Python framework were built under Xcode 14.3.1 on macOS 13.6.1. Other versions of Xcode have not been tested and may cause different results.

Package versioning

  • Distribution package version: 6.3.5.4619
  • munki core tools version: 6.3.5.4619
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.2.2.4618
  • Python package version: 3.10.11.4617

Attachment info

The munkitools-6.3.5.4619.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE (if you first sign the package). It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation.

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Munki 6.3.4 Official Release

07 Nov 17:43
Compare
Choose a tag to compare

This is the official release of Munki 6.3.4, a bug-fix and minor change release of the Munki tools.

Fixes

  • Fix for incorrect date/time displayed for force_install_after_date items when the date is after an upcoming change to/from Daylight Saving Time: faa123f Thanks to @poundbangbash for the issue report.
  • Check for valid package extension (not installer item extension) when attempting to get metadata for a package: 54a85fb Thanks to @nmcspadden for the issue report. This addresses a rare issue with disk images that contain disk images.

Other changes

  • Tweaks to help text for makepkginfo: bb77913
  • CSS changes that now allow some descriptive text to be selected (and copied) in Managed Software Center: 90677e5 Addresses #1036

A complete list of changes from the 6.3.3 release is here: v6.3.3...v6.3.4

Build info

The GUI apps and the Python framework were built under Xcode 15.0.1 on macOS 14.1. Other versions of Xcode have not been tested and may cause different results.

Package versioning

  • Distribution package version: 6.3.4.4599
  • munki core tools version: 6.3.4.4598
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.2.1.4599
  • Python package version: 3.10.11.4589

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are made available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Attachment info

The munkitools-6.3.4.4599.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE. It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation. A signed and notarized version of this package should be available eventually at https://github.com/macadmins/munki-builds/releases.

Munki 6.3.3 Official Release

02 Aug 16:22
Compare
Choose a tag to compare

This is the official release of Munki 6.3.3, a bug-fix and minor change release of the Munki tools

Fixes

  • Fix for an issue that caused app_usage_monitor to crash when Munki 6.3.2 was installed. Thanks to @sheagcraig. #1184
  • Fix for Python package preinstall and postinstall scripts when package is installed on a volume other than the current startup volume. Thanks to David Vandenborn for the issue report. 268171a

Other changes

  • Change to launchapp tool to normalize usernames to lowercase. Improves compatibility with organizations using Jamf Connect. Thanks to @MScottBlake. #1182
  • munkiimport: When generating a pkginfo filename, if there is a single supported_architecture, this is added to the filename. This makes it easier to distinguish between Intel and Apple silicon pkginfo files for the same product. Thanks to @nmcspadden. #1185

A complete list of changes from the 6.3.2 release is here: v6.3.2...v6.3.3

Build info

The GUI apps and the Python framework were built under Xcode 14.3 on macOS 13.5. Other versions of Xcode have not been tested and may cause different results.

Package versioning

  • Distribution package version: 6.3.3.4593
  • munki core tools version: 6.3.3.4593
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.2.0.4576
  • Python package version: 3.10.11.4589

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are made available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Attachment info

The munkitools-6.3.3.4593.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE. It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation. A signed and notarized version of this package should be available eventually at https://github.com/macadmins/munki-builds/releases.

Munki 6.3.2 Official Release

28 Jun 15:15
Compare
Choose a tag to compare

This is the official release of Munki 6.3.2, a bug-fix and minor change release of the Munki tools.

Fixes

  • A fix for an issue with munkiimport and makepkginfo, where they crash with distribution-style packages containing a payload-free package. See #1179

Other changes

  • Remove distutils.LooseVersion dependency; this is deprecated in Python 3.10. 213cc35 and a8494ab
  • Bump Python to 3.10.11. Bump PyObjC to 9.1.1. 5f64d79
  • Add macOS Sonoma software update catalog to the list of catalogs: 6591df3

A complete list of changes from the 6.3.1 release is here: v6.3.1...v6.3.2

Build info

The GUI apps and the Python framework were built under Xcode 14.3 on macOS 13.4.1. Other versions of Xcode have not been tested and may cause different results.

Package versioning

  • Distribution package version: 6.3.2.4588
  • munki core tools version: 6.3.2.4588
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.2.0.4576
  • Python package version: 3.10.11.4585

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are made available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Attachment info

The munkitools-6.3.2.4588.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE. It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation. A signed and notarized version of this package should be available eventually at https://github.com/macadmins/munki-builds/releases.

Munki 6.3.1 Official Release

02 May 16:11
Compare
Choose a tag to compare

This is the official release of Munki 6.3.1, a bug-fix release of the Munki tools.

Fixes

  • A fix for an issue with with items marked with autoremove=true and updates. fafca46 See also #1172
  • Update some messages seen at the command-line and in the logs that referred to ".managedsoftwareupdate.py" to refer to "managedsoftwareupdate" instead. (This was an unattended side-effect of using a binary wrapper in 6.3.0) 8e32338
  • Eliminate "Error reading: /Library/Managed Installs/AppleUpdates.plist" error messages when there are no pending updates (and therefore no AppleUpdates.plist file) 495e0e3

Other changes

  • Improved progress spinner in Managed Software Center, more closing matching current macOS appearance. Thanks to @chrisgrande 535751b

A complete list of changes from the 6.3 release is here: v6.3.0...v6.3.1

Build info

The GUI apps and the Python framework were built under Xcode 14.3 on macOS 13.3.1. Other versions of Xcode have not been tested and may cause different results.

Package versioning

  • Distribution package version: 6.3.1.4580
  • munki core tools version: 6.3.1.4580
  • LaunchAgents/LaunchDaemons version: 3.0.3265
  • Apps package version: 6.2.0.4576
  • Python package version: 3.10.10.4574

Signed/notarized builds

Thanks to the efforts of @erikng and @natewalck, signed and notarized builds of Munki tools packages are made available at https://github.com/macadmins/munki-builds/releases. There may be a delay for new releases -- please be patient.

Attachment info

The munkitools-6.3.1.4580.pkg attachment available here is an unsigned and unnotarized package that should install without requiring a restart unless upgrading from an extremely old Munki tools (like one of the 3.x releases or earlier). It should be suitable for most initial deployment scenarios, including those driven by DEP/ADE. It does not include a component to trigger "bootstrapping" or any other automatic run of the tools after installation. A signed and notarized version of this package should be available eventually at https://github.com/macadmins/munki-builds/releases.