Skip to content
Alex Narvey edited this page Feb 13, 2026 · 22 revisions

Current version Python 3.10

The current version of MunkiReport 5.8.0 has been tested with Mac Admins Python 3.10. The recommended version 3.10 of Mac Admins Python can be found on this page: https://github.com/macadmins/python/releases/tag/v3.10.11.80742

With more modern versions of Mac Admins Python (e.g. 3.11, 3.12, 3.13) munkireport will fail to run.

Updating Python

It is possible to use a more modern Python if you make some adjustments. These adjustments are based on suggestions from Greg Neagle and Simon Andersen.

You will have to modify the munkireport runner at: public/assets/client_installer/payload/Library/LaunchDaemons/com.github.munkireport.runner.plist

To include:

<key>EnvironmentVariables</key>
<dict>
   <key>PYTHONHOME</key>
   <string>/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current</string>
</dict>

i.e.

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>Label</key>
	<string>com.github.munkireport.runner</string>
	<key>Program</key>
	<string>/usr/local/munkireport/munkireport-runner</string>
	<key>EnvironmentVariables</key>
	<dict>
   		<key>PYTHONHOME</key>
   		<string>/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current</string>
	</dict>
	<key>RunAtLoad</key>
	<true/>
	<key>KeepAlive</key>
	<dict>
		<key>PathState</key>
		<dict>
			<key>/Users/Shared/.com.github.munkireport.run</key>
			<true/>
		</dict>
	</dict>
</dict>
</plist>

Then you must make a new client and distribute in the normal way.

You can now use a more modern Python such as: https://github.com/macadmins/python/releases/tag/v3.12.1.80742

Once the above change has been made the command /usr/local/munkireport/munkireport-runner will no longer work.

You will be able to run munkireport from the command line using this command:

sudo PYTHONHOME='/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current' /usr/local/munkireport/munkireport-runner

Clone this wiki locally