1 Introduction

This document provides information on select issues discovered in the released versions of OpenCore and provides workarounds whenever possible. This document is updated after OpenCore is released and is thus not contained in the binary packages.

This document contains issues considered causing significant impact on the end-user. More details on all known issues including feature requests and development version issues can be found at Acidanthera Bugtracker.

2 Issue list

• Identifier: ERR059-1
  Published: 2020-06-02 08:06 MSK
  Updated: 2020-06-21 18:22 MSK
  Affected versions: 0.5.9
  Resolved in: 0.6.0 ( 9d5aa267)
  Description:

  Boot picker menu may not show when upgrading macOS with the following error:

  OCUI: Entry kind 16 unsupported for Icon
  OCB: ShowMenu failed - Unsupported
  Halting on critical error

  Possible workarounds:

  • Add run-efi-updater variable with NO string value OR
  • Avoid using OpenCanopy OR
  • Disable showing picker by setting ShowPicker to false OR
  • Update to master version

• Identifier: ERR059-2
  Published: 2020-06-02 08:06 MSK
  Updated: 2020-06-21 18:22 MSK
  Affected versions: 0.5.9
  Resolved in: 0.6.0 ( 670d4e0c)
  Description:

  Incorrect operating system may be selected as the default during macOS upgrade when Windows and macOS are installed on the same disk. Reference: acidanthera/bugtracker#948.

  Possible workarounds:

  • Add run-efi-updater variable with NO string value OR
  • Install Windows on a separate disk OR
  • Update to master version

• Identifier: ERR059-3
  Published: 2020-06-21 18:22 MSK
  Updated: 2020-06-21 18:22 MSK
  Affected versions: 0.5.9
  Resolved in: 0.6.0 ( 2449e47c)
  Description:

  DEBUG builds may fail to load due to unaligned access assertion when accessing device paths. Reference: acidanthera/bugtracker#951.

  Possible workarounds:

  • Avoid using DEBUG builds OR
  • Update to master version

• Identifier: ERR059-4
  Published: 2020-06-24 21:18 MSK
  Updated: 2020-07-05 23:20 MSK
  Affected versions: 0.5.9
  Resolved in: 0.6.0 ( d8ace476)
  Description:

  Driver injection into kernel collections normally used in macOS 11, and required for macOS 11 installer, is unsupported.

  Possible workarounds:

  • For preview version of KernelCollection injection code please update to commit d8ace476 and make sure that variables forcing legacy kernel loading (booter-fileset-kernel and booter-fileset-basesystem) are deleted from NVRAM.
  • For preinstalled versions of macOS 11 add NVRAM variable
    7C436110-AB2A-4BBB-A880-FE41995C9F82:booter-fileset-kernel with 00 value; for some EfiBoot variants it may also be required to set booter-fileset-basesystem variable with 00 value.

• Identifier: ERR059-5
  Published: 2020-07-25 18:24 MSK
  Updated: 2020-07-25 18:24 MSK
  Affected versions: 0.0.3-0.5.9
  Resolved in: 0.6.0 ( 426a5dbe)
  Description:

  OSXSAVE CPUID feature may not be reported to macOS release kernels when emulating the CPUID causing crashes of select programs relying on Hypervisor.framework like Docker. Reference: acidanthera/bugtracker#1035.

  Possible workarounds:

  • Manually enable the OSXSAVE bit in ECX register OR
  • Update to master version

• Identifier: ERR060-1
  Published: 2020-08-22 03:10 MSK
  Updated: 2020-08-22 03:10 MSK
  Affected versions: 0.0.1-0.6.0
  Resolved in: 0.6.1 ( 89be8ea5)
  Description:

  APFS-formatted macOS Recovery (e.g. Big Sur Recovery) will not load with a boot failure error. Reference: acidanthera/bugtracker#1078.

  Possible workarounds:

  • Enable JumpstartHotPlug OR
  • Update to master version

• Identifier: ERR061-1
  Published: 2020-09-11 14:55 MSK
  Updated: 2020-09-11 14:55 MSK
  Affected versions: 0.5.3-0.6.1
  Resolved in: 0.6.2 ( d3cf117c)
  Description:

  APFS-formatted drives previously made available with ApfsImageLoader.efi driver are no longer visible with OpenCore builtin EnableJumpstart APFS functionality on platforms that need UnblockFsConnect quirk. Reference: acidanthera/bugtracker#1128.

  Possible workarounds:

  • Update to master version OR
  • Disable ConnectDrivers and enable GlobalConnect (may cause performance and compatibility issues depending on the driver use)

• Identifier: ERR062-1
  Published: 2020-10-25 01:22 MSK
  Updated: 2020-11-01 13:28 MSK
  Affected versions: 0.6.1-0.6.2
  Resolved in: 0.6.3 ( 1b004149)
  Description:

  Booting Big Sur beta 10 or newer will cause a kernel panic in apfs.kext with the Rooting from the live fs of a sealed volume is not allowed on a RELEASE build message. Reference: acidanthera/bugtracker#1235.

  Possible workarounds:

  • Update to master version OR
  • Set SecureBootModel to Disabled

  Note: On virtual machines ForceSecureBootScheme will also need to be enabled if SecureBootModel is different from x86legacy or Disabled.

• Identifier: ERR067-1
  Published: 2021-02-20 10:42 MSK
  Updated: 2021-02-20 10:42 MSK
  Affected versions: 0.6.6
  Resolved in: 0.6.7 ( b4449f48)
  Description:

  Loading OpenCore via bootstrap may fail on certain Mac firmwares. Reference: acidanthera/bugtracker#1502.

  Possible workarounds:

  • Update to master version

• Identifier: ERR088-1
  Published: 2023-01-07 21:29 MSK
  Updated: 2023-01-07 21:29 MSK
  Affected versions: 0.8.8
  Resolved in: 0.8.9 ( 092af5d9)
  Description:

  Loading macOS in OpenDuet may fail. Reference: acidanthera/bugtracker#2190.

  Possible workarounds:

  • Update OpenDuet to master version

• Identifier: ERR088-2
  Published: 2024-02-06 13:36 GMT
  Updated: 2024-02-06 13:36 GMT
  Affected versions: 0.8.8+
  Resolved in: Won’t fix
  Description:

  Some released versions of Linux kernel 6.7 and release candidates of 6.8 fail to load when using OpenDuet. This has been acccepted as a bug in the Linux kernel, for which a fix will be released in 6.8 and backported to 6.7. Reference: acidanthera/bugtracker#2371.

  Possible workarounds:

  • Use OpenDuet 0.8.7 or earlier, or wait for fixed Linux kernels to be released.

• Identifier: ERR098-1
  Published: 2024-02-08 09:28 GMT
  Updated: 2024-02-08 09:28 GMT
  Affected versions: 0.9.8
  Resolved in: 0.9.9 ( 4314fb31)
  Description:

  ocvalidate may report that OpenVariableRuntimeDxe.efi is incompatible with FirmwareSettingsEntry.efi even when FirmwareSettingsEntry.efi is not included and active in config.plist Drivers section. Reference: acidanthera/bugtracker#2379.

  Possible workarounds:

  • For 0.9.8 use version of ocvalidate provided in a comment on the above issue.

• Identifier: ERR102-1
  Published: 2024-11-30 18:46 GMT
  Updated: 2024-11-30 18:46 GMT
  Affected versions: 1.0.2
  Resolved in: 1.0.3 ( 35bcb134)
  Description:

  Vault sign.command from 1.0.2 cannot correctly sign 1.0.2 RELEASE build. Reference: acidanthera/bugtracker#2443.

  Possible workarounds:

  • If it is required to sign 1.0.2 releases, the updated sign.command provided with 1.0.3 may be used.