Repository navigation
Python updates
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.
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
- General Upgrade Procedures
- How to Upgrade Versions
- Troubleshooting Upgrades
- Migrating sqlite to MySQL