Recovery

Like the Escrow Buddy, upon which this fork is based, Bootstrap Buddy has been designed and tested to ensure it does not interfere with the login process. If any of its functions fail, the login process is intended to continue as normal.

However, as with any macOS authorization plugin, there is a possibility that it may not function as expected, potentially preventing normal login (indicated by the „no” shake when correct credentials are entered at the login window).

If this occurs, the recommended remediation is to use macOS Recovery mode to reset the authorization database by following these steps:

1. Enter macOS Recovery (see Apple’s instructions for Intel or Apple Silicon Macs).

2. Once in Recovery, open Disk Utility.

3. Select Macintosh HD (or the name of the startup disk) and click Mount. Enter a FileVault password when prompted.

4. Quit Disk Utility, then choose Terminal from the Utilities menu.

5. Run this command:

    cd "/Volumes/Macintosh HD/var/db" && rm -v auth.db*
   

   Substitute the name of the startup disk if it’s not Macintosh HD. If the command is successful, you’ll see these filenames in the output:

    auth.db
    auth.db-shm
    auth.db-wal
   

6. Quit Terminal, then choose Restart from the Apple menu. You should be able to log in normally.