{"id":121,"date":"2019-01-29T06:00:57","date_gmt":"2019-01-29T06:00:57","guid":{"rendered":"https:\/\/www.alansiu.net\/munkiguide\/?p=121"},"modified":"2025-08-07T04:36:25","modified_gmt":"2025-08-07T04:36:25","slug":"managedoptionalinmanifests","status":"publish","type":"post","link":"https:\/\/www.alansiu.net\/munkiguide\/managedoptionalinmanifests\/","title":{"rendered":"Managed installs, managed updates, optional installs, and managed uninstalls in Munki manifests"},"content":{"rendered":"\r\n<p class=\"wp-block-paragraph\">So now that your Munki client is pulling its manifest from the Munki repo, you can use different manifest options to make software available, mandatory for install, or mandatory for removal.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"737\" height=\"435\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest01.png\" alt=\"Optional install available to be removed\" class=\"wp-image-122\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest01.png 737w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest01-300x177.png 300w\" sizes=\"auto, (max-width: 737px) 100vw, 737px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">When the item is put in optional installs, users can launch up <strong>Managed&nbsp;Software&nbsp;Center<\/strong>, click on the <strong>Software<\/strong> tab, and then see either <strong>INSTALL<\/strong> (if the item is not yet installed) or <strong>REMOVE<\/strong> (if the item is already installed) as options for that item. Only items that are optional installs will ever show up in the <strong>Software<\/strong> tab. Managed installs and managed uninstalls will not show up.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"477\" height=\"207\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest02.png\" alt=\"Adding an item to Managed Installs in a manifest\" class=\"wp-image-123\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest02.png 477w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest02-300x130.png 300w\" sizes=\"auto, (max-width: 477px) 100vw, 477px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Go ahead and take Firefox out of <em>Optional&nbsp;Installs<\/em> and put it in <strong>Managed&nbsp;Installs<\/strong> and then save your changes.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"397\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest03-1024x397.png\" alt=\"Managed Software Center with no optional installs\" class=\"wp-image-125\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest03-1024x397.png 1024w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest03-300x116.png 300w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest03-768x297.png 768w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest03.png 1144w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Click the <strong>CHECK&nbsp;AGAIN<\/strong> button in <strong>Managed&nbsp;Software&nbsp;Center<\/strong>. Now that there are no longer any optional installs, you&#8217;ll see that the <em>Software<\/em> tab is greyed out.<\/p>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Now, go ahead and delete <strong>Firefox.app<\/strong> from the <strong>\/Applications<\/strong> folder, and then click <strong>CHECK&nbsp;AGAIN<\/strong> in <strong>Managed&nbsp;Software&nbsp;Center<\/strong>.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"297\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest04-1024x297.png\" alt=\"Managed Software Center showing a managed install as ready to install\" class=\"wp-image-128\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest04-1024x297.png 1024w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest04-300x87.png 300w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest04-768x223.png 768w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest04.png 1143w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Since Munki sees that Firefox is missing from the \/Applications folder and since the manifest your client is using has Firefox as a managed install, Munki makes sure that Firefox is installed and thus wants to re-install Firefox. If you then click <strong>UPDATE<\/strong> in <strong>Managed&nbsp;Software&nbsp;Center<\/strong>, Munki should reinstall Firefox. And then if you click <em>CHECK&nbsp;AGAIN<\/em> again, it should see Firefox is already installed and not try to do anything else.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"457\" height=\"251\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest05.png\" alt=\"An item in the Managed Updates section of a manifest\" class=\"wp-image-131\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest05.png 457w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest05-300x165.png 300w\" sizes=\"auto, (max-width: 457px) 100vw, 457px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Another place you can put items in a manifest is <strong>Managed&nbsp;Updates<\/strong>. All that means is, if someone installed an item not using Managed Software Center, Munki will make sure that it&#8217;s automatically kept up to date, as if it were installed via Managed Software Center.<\/p>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">So if someone installs Firefox on her own, and you don&#8217;t have Firefox as a managed update, but you keep importing new versions of Firefox into your Munki repo, she&#8217;ll see Firefox as an optional upgrade in Managed Software Center, but she can also keep ignoring the upgrade prompt. But if you have Firefox as a managed update, she&#8217;ll just have her version of Firefox automatically updated to the latest you have available in your Munki repo that&#8217;s in the same catalog as the manifest her computer is using.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"469\" height=\"252\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest06.png\" alt=\"Managed Uninstalls in MunkiAdmin for a manifest\" class=\"wp-image-133\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest06.png 469w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest06-300x161.png 300w\" sizes=\"auto, (max-width: 469px) 100vw, 469px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Final one to try (ignore featured items for now\u2014that&#8217;s a subset of optional installs, and it&#8217;s not critical to know about at this stage) is taking Firefox out of managed installs and out of optional installs, and then putting it into <strong>Managed&nbsp;Uninstalls<\/strong> and then saving.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"301\" src=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest07-1024x301.png\" alt=\"Managed Software Center prompting to remove a managed uninstall\" class=\"wp-image-134\" srcset=\"https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest07-1024x301.png 1024w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest07-300x88.png 300w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest07-768x226.png 768w, https:\/\/www.alansiu.net\/munkiguide\/wp-content\/uploads\/2019\/01\/iteminmanifest07.png 1142w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Once you <strong>CHECK&nbsp;AGAIN<\/strong> in <strong>Managed&nbsp;Software&nbsp;Center<\/strong>, you should see MSC prompting to remove Firefox, because it&#8217;s a managed uninstall. If you click <strong>UPDATE<\/strong>, MSC will remove Firefox from your client machine.<\/p>\r\n\r\n\r\n\r\n<p class=\"wp-block-paragraph\">Note that as a Munki admin, you shouldn&#8217;t ever have the same item in the same manifest be both a managed install <em>and<\/em> an optional install, a managed install <em>and<\/em> a managed uninstall, or a managed uninstall <em>and<\/em> an optional install. If you do that, you may get unexpected behavior.<\/p>\r\n","protected":false},"excerpt":{"rendered":"<p>So now that your Munki client is pulling its manifest from the Munki repo, you can use different manifest options to make software available, mandatory for install, or mandatory for removal. When the item is put in optional installs, users can launch up Managed&nbsp;Software&nbsp;Center, click on the Software tab, and then see either INSTALL (if [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[1],"tags":[],"class_list":["post-121","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"jetpack_shortlink":"https:\/\/wp.me\/paDrAJ-1X","jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/posts\/121","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/comments?post=121"}],"version-history":[{"count":11,"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/posts\/121\/revisions"}],"predecessor-version":[{"id":519,"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/posts\/121\/revisions\/519"}],"wp:attachment":[{"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/media?parent=121"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/categories?post=121"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.alansiu.net\/munkiguide\/wp-json\/wp\/v2\/tags?post=121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}