Repository navigation
Bootstrapping With Munki
"Bootstrapping" mode is intended for initial deployment scenarios. When Munki is set to "bootstrap", when the Mac is at the loginwindow, Munki will check for and install updates. If a reboot is required after installing updates, after the reboot, Munki will check and install again, continuing until there are no updates to be installed. This allows you to bootstrap the configuration of a machine, installing all managed software, with no user intervention. (Before the introduction of Apple silicon Macs, this also included the installation of any and all available Apple software updates.)
Bootstrapping was originally designed and intended for a time when a common way to deploy a new Mac was to "image" it -- that is, to wipe the internal disk and restore a pre-configured disk image, which might contain, among other things, the Munki tools set to bootstrapping mode. On first boot after "imaging", the Mac would then contact the Munki server, check for updates, and install anything and everything defined in its manifests.
With "modern" deployment methods like Apple's Device Enrollment Protocol (DEP) or Automated Device Enrollment (ADE), where a Mac enrolls in your organization's MDM at first boot, Munki and bootstrapping mode can still be useful in the scenario where initial user creation during the Setup Assistant is suppressed (because the initial user is created via AD/LDAP/Cloud IdP login). In this scenario, after the Setup Assistant exits, the machine is then at the login window. If MDM has installed the Munki tools and set bootstrap mode, Munki can then take over and install additional software.
If the user sets up their own user account in the Setup Assistant, when the Setup Assistant exits, the Mac directly logs into that newly created user account, skipping the loginwindow, and Munki's bootstrapping mode is less useful, because the bootstrapping runs happen only at the loginwindow.
To take advantage of bootstrapping mode during DEP/ADE, you'll need to have your MDM install the Munki configuration, the Munki tools package, configure bootstrapping mode, and suppress creation of the initial user. (Often this requires creating a local admin user).
If instead, the initial user account is created in the Setup Assistant, you might want to look into triggering a managedsoftwareupdate --auto run after Munki is installed, as that will happen in the background even with a logged-in user.
Bootstrapping mode is enabled when the file /Users/Shared/.com.googlecode.munki.checkandinstallatstartup exists. You can create a package that installs that file, or you can have a script touch that file.
A package that installs the required file is available here: https://github.com/munki/contrib/blob/master/munki_kickstart.pkg?raw=true
Bootstrapping mode will disable itself once there are no additional changes to be made (installs or removals). You may also direcrtly disable bootstrap mode by removing /Users/Shared/.com.googlecode.munki.checkandinstallatstartup.
Since bootstrapping is intended for an initial deployment scenario, where the initial user has not yet logged in (and perhaps that account has not yet even been created), FileVault is generally not active in this state. But there are scenarios in which bootstrapping mode might be used when FileVault is active.
Munki has options to improve the bootstrapping experience on machines encrypted with FileVault: --set-bootstrap-mode and --clear-bootstrap-mode.
managedsoftwareupdate --set-bootstrap-mode creates the needed /Users/Shared/.com.googlecode.munki.checkandinstallatstartup file, and also turns off FileVault auto login (this is the automatic login to the account of the user who unlocks the FV2-encrpyted disk at boot), by setting the com.apple.loginwindow DisableFDEAutoLogin preference to True. (See deprecated Apple support article HT202842.)
managedsoftwareupdate --clear-bootstrap-mode removes the /Users/Shared/.com.googlecode.munki.checkandinstallatstartup file and resets the com.apple.loginwindow DisableFDEAutoLogin preference to its previous value.
When performing a macOS upgrade (using an Install macOS.app/startosinstall), Munki uses these new mechanisms in order to effectively re-bootstrap after an OS upgrade.
You probably won't need to use/care about these options when bootstrapping a brand-new machine, since it most likely will not have FileVault turned on, but if for some reason you do, you can use managedsoftwareupdate --set-bootstrap-mode to set up bootstrapping mode.
- Getting Started
- Overview
- Discussion Groups
- Demonstration Setup
- Glossary
- Frequently Asked Questions
- Contributing to Munki
- Release Notes
- Introduction
- New features
- Changes
- Introduction
- New features
- Removed features
- Python removal
- PPPC/TCC for Munki 7
- Middleware for Munki 7
- Logging
- Installation package changes
- Launchd job changes
- Introduction
- Staging macOS Installers
- Apple update changes
- Default Installs (Munki 6.1)
- Conditional Application Data (Munki 6.5)
- Introduction
- Munki Links
- Product Icons
- Screenshots In Product Descriptions
- Client Customization
- Customizing the sidebar
- Custom Help Content
- Featured Items
- Update Notifications:
- Managed Software Center Logging
- Localization
- Introduction
- iconimporter
- makepkginfo
- munkiimport
- managedsoftwareupdate
- makecatalogs
- manifestutil
- repoclean
- Preferences
- Default Repo Detection
- Default Manifest Resolution
- Managed Preferences Support In Munki
- Apple Software Updates With Munki
- Additional macOS configuration for Munki:
- Introduction to Pkginfo Files
- Supported Pkginfo Keys
- Important Pkginfo Features
- Installer type details:
- Pkginfo in Operation:
- Version comparisons
- Default Installs
- Removal of Unused Software
- Upgrading macOS:
- Apple Updates:
- Securing the Munki repo
- Preflight And Postflight Scripts
- Managed Software Center Logging
- Munki With Git
- Bootstrapping With Munki
- License Seat Tracking
- LaunchD Jobs and Changing When Munki Runs
- Web Request Middleware
- Repo Plugins
- Downgrading Software
- Downgrading Munki tools
- Authorized Restarts
- Allowing Untrusted Packages
- On Demand Items
- AutoPkg
- Repackaging
- Creating Disk Images
- Stupid Munki Tricks
- Troubleshooting
- Professional Support
- Building Munki packages
- Signing Munki
- Removing Munki
- Who's Using Munki
- More Links And Tools
- Munki 3 Information
- Munki 4 Information
- macOS Sonoma info
- macOS Monterey Info
- macOS Ventura info
- make_munki_mpkg.sh
- make_munki_mpkg_from_git.sh
- Munki packages and restarts
- Pkginfo For Apple Software Updates
- Managing Configuration Profiles
- Configuration Profile Emulation
- softwareupdate and Configuration profile notes
- About Munki's Embedded Python
- Customizing Python for Munki
- Modular Imaging with Munki
- Report Broken Client
- Munki Configuration Script
- Microsoft Office
- Adobe Products
- Upgrading macOS: