Offline macOS Recovery USB root-patching workflow designed for
cook0001/OpenCore-Legacy-Patcher
to eliminate post-install SSH workarounds on unsupported Macs.
Status note: The OCPBP architecture and target-scoped OCLP design plan are complete and queued to implement immediately after the Golden Gate kernel bring-up milestone clears external USB boot.
Why OCPBP Exists
Zero-SSH Offline Root Patching Before First Desktop Boot
macOS Tahoe / Legacy USB & GPU
Freshly installed macOS on unsupported Macs often boots without GPU acceleration, a working WindowServer, or legacy USB HID input — forcing users into SSH sessions or blind scripts just to apply root patches.
Single-USB Model: Pairs Apple's version-matched macOS Recovery (BaseSystem) with a dedicated OCPBP payload volume on the installer USB.
Exact Tooling Match: Uses Recovery's built-in /usr/bin/kmutil, /usr/sbin/bless, /usr/sbin/diskutil, and mount_apfs rather than bundling a second 30 GB macOS install.
100% Offline: Pre-stages matching Universal-Binaries.dmg, KDK, and MetallibSupportPkg assets on USB so patching needs no Wi-Fi or Ethernet in Recovery.
3-Part USB Layout
Partition / Volume
Role
Contents & Guarantees
1. USB OpenCore ESP (EFI)
Pre-boot Configuration
Model-specific OpenCore config enforcing SIP / Authenticated-Root flags (csr-active-config) and SecureBootModel=Disabled independently of internal NVRAM.
2. Installer / Recovery (BaseSystem)
Bootable Environment
Cleanly boots with basic GOP/VESA graphics and Apple USB drivers while providing version-exact kmutil, bless, and APFS snapshot utilities.
Step 1 — Install & Shut Down: Install macOS onto internal storage using the USB installer as usual, then power off.
Step 2 — Boot Recovery & Launch ocpbp: Hold Option → select EFI Boot → boot OCPBP / Installer Recovery, open Terminal, and launch ocpbp against the target internal volume.
Step 3 — Offline Patch, Snapshot & Reboot:OCPBP resolves the target APFS System + Data + Preboot group, verifies SIP/AR preflight, stages offline KDK/Metallib and root patches, rebuilds kernel collections via kmutil, runs bless --create-snapshot, syncs OpenCore to internal EFI if missing, and reboots into an already-patched desktop.