Munki
ManagedInstalls
Munki settings
Configuration Keys (59)
| Key | Type | Title |
|---|---|---|
SoftwareRepoURLBase URL for Munki repository. Default: "http://munki/repo" | string | — |
PFC_SegmentedControl_0required | string | — |
ClientIdentifierIdentifier for Munki client. Usually is the same as a manifest name on the Munki server. If this is empty or undefined, Munki will attempt the following identifiers, in order: fully-qualified hostname, "short" hostname, serial number and finally, "site_default". | string | Client Identifier |
ManagedInstallDirFolder where Munki keeps its data on the client. Default: "/Library/Managed Installs" | string | Managed Install Directory |
LocalOnlyManifestDefines the name of your LocalOnlyManifest. Setting this activates the feature. Unsetting it means Munki will remove the file on the next run. | string | Local Only Manifest |
SuppressAutoInstallMunki will not automatically install or remove items. Default: false | boolean | Suppress Auto Install |
SuppressLoginwindowInstallMunki will not install items while idle at the loginwindow except for those marked for unattended_install or unattended_uninstall. Default: false | boolean | Suppress Loginwindow Install |
InstallAppleSoftwareUpdatesInstall updates from an Apple Software Update server, in addition to "regular" Munki updates. Default: false | boolean | Install Apple Software Updates |
AppleSoftwareUpdatesOnlyOnly install updates from an Apple Software Update server. No Munki repository is needed or used. Default: false | boolean | Install Apple Software Updates Only |
UnattendedAppleUpdatesUpdates that declare no "must-close" applications, or have one or more "must-close" applications, none of which is running, and do not require a logout or restart will be installed as part of a normal periodic background run without notifying the user. Default: false | boolean | Unattended Apple Updates |
PerformAuthRestartsMunki will attempt to perform a filevault auth restart. Default: false | boolean | Perform FileVault Authorized Restarts |
RecoveryKeyFileAbsolute path to a plist file containing filevault credentials in key/value format. Used to perform auth restarts. | string | FileVault Credentials Path |
EmulateProfileSupportA bit of hack and not supported by Apple, it is disabled by default. To emulate profile installs, configuration profiles are read, and if they contain managed preferences, they are converted to MCX data that is added to a ComputerGroup in the local Open Directory store. Configuration profile payloads that are not managed preferences are ignored/skipped. | boolean | Emulate Profile Support (Big Sur) |
SuppressUserNotificationManaged Software Center will never notify the user of available updates. Default: false | boolean | Suppress Update Notifications |
SuppressStopButtonOnInstallManaged Software Center will hide the stop button while installing or removing software, preventing users from interrupting the install. Default: false | boolean | Suppress Stop Button On Install |
InstallRequiresLogoutManaged Software Center will require a logout for all installs or removals. Default: false | boolean | Require Logout for Installs & Uninstalls |
ShowRemovalDetailManaged Software Center will display detail for scheduled removals. Default: false | boolean | Show Removal Detail |
ShowOptionalInstallsForHigherOSVersionsManaged Software Center.app will show optional installs and updates that apply to macOS versions higher than the currently installed version. Default: false | boolean | Show Optional Installs For Higher OS Versions |
DaysBetweenNotificationsNumber of days between user notifications from Managed Software Center. Set to 0 to have Managed Software Center notify every time a background check runs if there are available updates. Default: 1 Range: 0 – — | integer | Days Between Notifications |
UseNotificationCenterDaysNumber of days Notification Center notifications should be used before switching to launching Managed Software Center. Default: 3 Range: 0 – — | integer | Use Notification Center Days |
MSCOfferToQuitBlockingAppsIf true, if there are any running blocking_applications for pending updates, a sheet will be displayed allowing the user to direct Managed Software Center to attempt to quit the blocking applications. Default: false | boolean | Offer To Quit Blocking Apps |
MSCOfferToForceQuitBlockingAppsIf this (and MSCOfferToQuitBlockingApps) is true, if a "polite" attempt to quit an application fails, a button to force quit the application will be displayed. Default: false | boolean | Offer To Force Quit Blocking Apps |
MSCOfferToUpdateOthersIf there is a mix of pending updates, some of which are blocked by open applications, and some that are not, and this preference is true (and so is MSCOfferToQuitBlockingApps), a button will be shown to allow users to proceed with updating the non-blocked updates. Default: false | boolean | Offer To Update Others |
PackageVerificationModeControls how Munki verifies the integrity of downloaded packages. (none = No integrity check is performed, hash = Integrity check is performed if package info contains checksum information, hash_strict = Integrity check is performed, and fails if package info does not contain checksum information.) Range: none, hash, hash_strict | string | Package Verification Mode |
MSCAllowNotificationWindowIf true, users can open the Managed Software Center settings window to specify allowed time windows for notifications. Default: false | boolean | Allowed Notification Window |
MSCAllowedNotificationWindowStartThe earliest hour that can be selected for allowed notifications. Default: 0 Range: 0 – 23 | integer | Allowed Notification Window Start |
MSCAllowedNotificationWindowEndOnly hours earlier than this can be selected (non-inclusive). Default: 24 Range: 0 – 24 | integer | Allowed Notification Window End |
FollowHTTPRedirectsDefines whether Munki will follow all, some or no redirects from the web server. (none = The default behaviour. No redirects are followed. https = Only redirects to URLs using HTTPS are followed. all = Redirects to both HTTP and HTTPS URLs are followed.) Range: none, https, all | string | Follow HTTP Redirects |
AdditionalHttpHeadersThis key provides the ability to specify custom HTTP headers to be sent with all curl() HTTP requests. | array | Additional HTTP Headers |
IgnoreSystemProxiesHTTP and/or HTTPS proxies set system-wide will be ignored, connections will be made directly. Default: false | boolean | Ignore System Proxies |
DownloadRetriesNumber of times to retry a failed download. Valid values are 0-10. Set to 0 to disable retries. Default: 0 Range: 0 – 10 | integer | Download Retries |
DownloadRetrySleepSecondsHow many seconds to wait between download retries. Valid values are 1-30. Default: 10 Range: 1 – 30 | integer | Download Retry Sleep Seconds |
PackageURLBase URL for Munki pkgs. Useful if your packages are served from a different server than your catalogs or manifests. | string | Base Package URL |
CatalogURLBase URL for Munki catalogs. Useful if your catalogs are served from a different server than your packages or manifests. | string | Base Catalog URL |
ManifestURLBase URL for Munki manifests. Useful if your manifests are served from a different server than your catalogs or manifests. | string | Base Manifest URL |
IconURLBase URL for product icons. Useful if your icons are served from a different server or different directory than the default. | string | Base Icon URL |
ClientResourceURLBase URL for custom client resources for Managed Software Center. Useful if your resources are served from a different server or different directory than the default. | string | Base Client Resource URL |
ClientResourcesFilenameSpecific filename to use when requesting custom client resources. | string | Client Resources Filename |
HelpURLURL to open/display when the user selects "Managed Software Center Help" from Managed Software Center's Help menu. | string | Help URL |
LicenseInfoURLURL for Munki to query a webserver to determine if there are available seats for licensed software (or any software you wish to make available via optional_installs, yet control the number of deployed copies). | string | License Info URL |
SoftwareUpdateServerURLCatalog URL for Apple Software Updates. If undefined or empty, Munki will use the same catalog that the OS uses when you run Apple's Software Update application or call /usr/sbin/softwareupdate. | string | Software Update Server URL |
UseClientCertificateUse an SSL client certificate when communicating with the Munki server. Requires an https:// URL for the Munki repo. Default: false | boolean | Use Client Certificate |
UseClientCertificateCNAsClientIdentifierUse the CN of the client certificate as the Client Identifier. Used in combination with the UseClientCertificate key. Default: false | boolean | Use Client Certificate CN As Client Identifier |
ClientCertificatePathAbsolute path to a client certificate. There are 3 defaults for this key. Concatenated cert/key PEM file accepted. | string | Client Certificate Path |
ClientKeyPathAbsolute path to a client private key. | string | Client Key Path |
SoftwareRepoCAPathPath to the directory that stores your CA certificate(s). | string | Software Repo CA Path |
SoftwareRepoCACertificateAbsolute path to your CA Certificate. | string | Software Repo CA Certificate |
LogFilePrimary log is written to this file. Other logs are written into the same directory as this file. Default: "/Library/Managed Installs/Logs/ManagedSoftwareUpdate.log" | string | Log File |
LogToSyslogLog to syslog in addition to ManagedSoftwareUpdate.log. Default: false | boolean | Log to Syslog |
LoggingLevelHigher values cause more detail to be written to the primary log. Default: 1 | integer | Logging Level |
MSULogEnabledLog user actions in the GUI. Default: false | boolean | Log Enabled |
MSUDebugLogEnabledDebug logging for Managed Software Center. Default: false | boolean | Debug Log Enabled |
PFC_SegmentedControl_Pluginsrequired | string | — |
AccessKeyMunki has a feature which enables Mac administrators to use middleware to change munki's HTTP request. S3-Auth uses this feature to create the HTTP headers necessary to authenticate to S3. AccessKey for S3 bucket. | string | Access Key |
RegionMunki has a feature which enables Mac administrators to use middleware to change munki's HTTP request. S3-Auth uses this feature to create the HTTP headers necessary to authenticate to S3. Region for S3 bucket. | string | — |
SecretKeyMunki has a feature which enables Mac administrators to use middleware to change munki's HTTP request. S3-Auth uses this feature to create the HTTP headers necessary to authenticate to S3. SecretKey for S3 bucket. | string | Secret Key |
S3EndpointMunki has a feature which enables Mac administrators to use middleware to change munki's HTTP request. S3-Auth uses this feature to create the HTTP headers necessary to authenticate to S3. S3 Endpoint for bucket. | string | S3 Endpoint |
IgnoreMiddlewareIf true, Munki will ignore installed middleware. Useful for when moving away from middleware. Default: false | boolean | Ignore Middleware |
AggressiveUpdateNotificationDaysThis preference controls how many days after one or more pending updates are ignored that aggressive user notification begins. Setting this to 0 never triggers this aggressive behavior. Default: 14 Range: 0 – — | integer | Aggressive Update Notification Days |
HTTPHeader | string | HTTPHeader |