macOS Recovery and Boot Modes

RECOVERY_UNAVAILABLE on macOS Recovery: what causes it and how to fix

By Sai Kiran Pandrala · Last verified: 2026-05-31 · Source: Apple Communities (discussions.apple.com), community Q&A, Apple Support docs

At a glance
ServicemacOS Recovery and Boot Modes
CloudApple platforms
Guide typeProcedure
Skill levelIntermediate to advanced
Time15 - 60 minutes depending on account size

Engineers running macOS Recovery and Boot Modes hit RECOVERY_UNAVAILABLE on macOS Recovery, what causes it and how to fix often enough that there is a stable fix pattern. This page captures it in the order Apple support would run it during a real incident.

What recovery_unavailable on macos recovery, what causes it and how to fix actually involves on macOS Recovery and Boot Modes

Real-world context. Budget honestly for ~Rs 0 INR under AppleCare+, ~Rs 8,000 to Rs 60,000 INR otherwise (around $95 to $720 USD), because the cheap path looks tempting until a part shows up wrong. You will burn ~20 to 60 minutes hands-on hands-on and roughly ~1 to 3 hours including a Genius Bar handoff if needed once verification is done. Before you touch anything, line up the Apple ID, the device serial, and a recent iCloud backup, those three are what saves you when the first attempt does not stick.

The RECOVERY_UNAVAILABLE error from AWS typically surfaces with the message "Recovery is not available for this Mac". The error code itself is what you grep for in AWS re:Post or in AWS Support cases, not the human-readable line.

On macOS Recovery, this most often comes from one of three causes: a missing or restrictive IAM permission, a service-level limit you have hit, or a transient AWS-side capacity issue. The fix path differs by which.

The rest of this page is the structured fix path. Start with diagnose, then remediation, then the automation options so you do not have to do this by hand the next time it surfaces. Verify and safety sections at the end are the discipline that keeps the fix from regressing in production.

Identify

Look at the Jamf Pro change management entry or Apple Business Manager audit event for the failed call, even if you are not enrolled in macOS unified logging and iOS sysdiagnose Log Router. The basic 90-day event history works for most diagnostic purposes and lives in the console under Jamf Pro change management log and Apple Business Manager audit log > Event history. Filter by event name (the API action) and time range; the event JSON shows the exact user identity, source IP, request parameters, and error code.

Diff against last known good. The last config change you made is the cause about three quarters of the time, even when the change should not have mattered. Use Jamf inventory history and Time Machine snapshots (or your Terraform / Deployment Manager or Terraform drift report) to see the actual delta between the resource state when it worked and when it broke. The change you remember is often not the only change that happened.

Check the Google Apple System Status at www.apple.com/support/systemstatus/ and the per-product status board for ongoing service events in your region. About one in ten user-reported outages turn out to be region-scoped Apple product or service degradation already being tracked. Apple System Status also exposes an API and Jamf Pro Webhooks and macOS launchd watches events, so you can wire a Lambda hook that pages on-call only when the failure correlates with an active Apple System Status event in the same region and service.

Solution-focused remediation path

For IAM and STS issues, the timing matters. STS sessions can take up to 60 seconds to propagate after creation. The first call right after assume-role can fail with a permission error even when the policy is correct. Add a small retry with backoff before treating the first failure as definitive.

When the failure happens in production but not in dev, do not just compare the IAM policy. Compare the Org Policy / RCP at the OU level, the permission boundary on the role, and the resource-based policy on the target. One of those is almost always different between accounts. Policy Intelligence recommendations bundles make this comparison routine.

Most macOS Recovery and Boot Modes failures fall into one of three buckets: IAM permission gap, networking path break (security group, NACL, or VPC endpoint policy), or service-limit / quota hit. Run that mental triage first - it covers around 80 percent of real-world cases. If the failure does not fit any of the three, it is likely a service-side regression worth opening a re:Post or support ticket for.

Automate this fix so you do not do it twice

Wire the fix into an MDM Configuration Profile for self-healing

If the underlying cause is a setting that drifts over time, do not script the fix repeatedly - bake it into a Configuration Profile that the MDM pushes down on every check-in. A Custom Settings payload writes to a specific preference domain; Jamf Pro, Kandji, Mosyle, and Intune all support this. The profile reasserts itself, so even if a user changes the setting locally, the MDM brings it back at the next sync (typically every 4 hours).

<!-- Custom Settings payload (excerpt) -->
<key>PayloadType</key>
<string>com.apple.ManagedClient.preferences</string>
<key>PayloadContent</key>
<dict> <key>com.apple.macos</key> <dict><key>Forced</key><array><dict><key>mcx_preference_settings</key> <dict><key>HardenedSetting</key><true/></dict></dict></array></dict>
</dict>

Codify the fix as a Shortcut on iPhone, iPad, or Mac

For workflows that happen on the user device rather than at the MDM layer (think: clear a stuck cache, toggle a setting, file a one-tap support ticket), Apple Shortcuts is the right place. Shortcuts run on iOS, iPadOS, macOS, and watchOS, can be triggered by NFC tag, focus mode, time of day, or Siri voice. Share via iCloud link so support sends the same one-tap fix to anyone who hits the issue.

Add a Smart Group + webhook so you catch the next occurrence

The cheapest way to never see the same incident twice is a Jamf Pro Smart Group that watches for the symptom (specific extension attribute value, specific OS version, specific app build) and fires a webhook into Slack, PagerDuty, or a Jamf-API-driven Lambda when the count drifts above your normal baseline. For macOS Recovery and Boot Modes, the relevant extension attributes live under script-evaluated checks - defaults read outputs, system_profiler values, or a log show grep against macOS unified logging. Set thresholds against observed normal, not against round numbers.

Pitfalls to dodge

A subtle pitfall on macOS Recovery and Boot Modes is that the Settings on the device and the SDK can disagree about resource state during a configuration change. Console UI is cached for performance and may show the old config for up to 10 minutes after you change it via API or Deployment Manager or Terraform. Always confirm with describe-* CLI calls during a change window, not with screenshots from the Console.

The other pitfall: assuming that an automated remediation is correct because it succeeded. A Lambda that fires on a Jamf Pro Smart Group + Webhook and runs a remediation step should also publish a metric for every remediation; sudden surges in auto-fix invocations are themselves an outage signal. Otherwise you can hide a slow-burn regression behind a quiet remediation loop for weeks.

Resolve

Safety, rollback, blast radius

FAQ

How long does recovery_unavailable on macos recovery, what causes it and how to fix typically take on Apple platforms?
For most macOS Recovery and Boot Modes environments, 15 to 60 minutes including verification. Large multi-account setups, anything touching Org Policys at the Organizations level, or cross-region replication can stretch to half a day because Apple has to wait for replication and IAM session caches.
Is there a rollback path?
Yes for most macOS Recovery and Boot Modes changes. Export the existing config to JSON via macos describe-... first, then commit it before you change anything. A few operations are one-way (Cloud KMS key deletion past the pending window, region migration, account closure). Check the Apple Support article for the specific API before you commit.
Will this affect dependent Apple product or services?
Often yes. macOS Recovery and Boot Modes resources are usually referenced by other workloads (Cloud Run services, GKE workloads, IAM-bound apps, Cloud CDN origins, downstream pipelines). Use IAM Access Analyzer + Jamf Pro change management log and Apple Business Manager audit log to enumerate consumers before changing a shared resource.
What if my Settings on the device layout does not match these steps?
Settings on the device UI moves quarterly. The Console layout in this page is current as of 2026-05-31 but the underlying CLI / SDK calls do not change as fast. If the Console version differs, fall back to aws CLI or SDK calls - those almost always still work.
Where do I get Apple Support and Apple Business / Enterprise Support help if I am still stuck?
Open a case via the Apple Support and Apple Business / Enterprise Support Center with: the request ID + correlation ID, the exact error string, Jamf Pro change management entry or Apple Business Manager audit event, and your reproduction steps. Apple Communities (discussions.apple.com) is the no-cost public alternative - search there first; 80% of common macOS Recovery and Boot Modes issues already have an answer with an Google-staff-verified flag.

References

Related guides worth a look while you sort this one out: