RecoveryOS - Revision history

HappyMac3920: /* Downloading Apple Silicon Diagnostics */

2022-11-07T20:05:43Z

‎Downloading Apple Silicon Diagnostics

HappyMac3920: Updated examples for newer devices.

2022-09-16T20:27:00Z

Updated examples for newer devices.

HappyMac3920 at 20:10, 3 September 2022

2022-09-03T20:10:36Z

HappyMac3920 at 11:40, 11 August 2022

2022-08-11T11:40:31Z

HappyMac3920 at 15:52, 9 August 2022

2022-08-09T15:52:56Z

HappyMac3920 at 07:23, 23 July 2022

2022-07-23T07:23:14Z

Nyuszika7H: Added DISPLAYTITLE

2022-04-18T20:17:13Z

Added DISPLAYTITLE

HappyMac3920: /* Apple Silicon based Macs */

2022-04-18T19:45:56Z

‎Apple Silicon based Macs

HappyMac3920: Added diagnostics.

2022-04-18T19:45:13Z

Added diagnostics.

HappyMac3920: Added recoveryOS, will soon add Mac Diagnostics.

2022-04-17T19:28:09Z

Added recoveryOS, will soon add Mac Diagnostics.

New page

recoveryOS is the recovery environment used in macOS, watchOS, tvOS and audioOS. 
This is not the same as the iBoot [[Recovery Mode]] available on most Apple devices, as this type of recovery environment requires the device to be plugged into a computer.
== macOS ==
recoveryOS for macOS had its first introduction with Mac OS X Lion. At that time, Apple stopped selling Mac OS X through DVD's, and instead, they provided either USB sticks, or it could be downloaded through the Mac App Store. Apple also introduced a recovery environment, that in case a macOS installation is corrupted, it could recover itself by reinstalling macOS through the internet, without the need to reinstall macOS through a DVD.
=== Booting to recovery mode ===
==== Intel based Macs (including T2 Macs) ====
To boot to the local recovery mode, press Command + R at the same time during bootup until you see the Apple logo. To get the latest version of macOS (Internet Recovery), press Option (Alt) + Command + R at the same time until you see a spinning globe with text "Starting Internet Recovery. This may take a while.". You may need to choose a Wi-Fi network in order to download recoveryOS. To boot to the original macOS that your computer shipped with (or the closest version available), press Shift + Option (Alt) + Command + R at the same time until you see a spinning globe with text "Starting Internet Recovery. This may take a while.". You may need to choose a Wi-Fi network in order to download recoveryOS.
==== Apple Silicon based Macs ====
Press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon).
=== Whats included in recovery mode ===
- Restore from Time Machine: restore from a Time Machine backup.
- Reinstall macOS: installs macOS through the internet.
- Safari (minimal version, does not have the capability to play videos): User can use the internet to troubleshoot the Mac. The default home page is an HTML file which contains information about using recoveryOS.
- Disk Utility: Can be used to repair the disk using First Aid or erase the disk.
There are more utilities that can be accesed through the menu bar by clicking Utilities: 
- Startup Security Utility: On normal Intel Macs, it can be used to enable/disable the firmware password (only on regural Intel and T2 Macs). On T2/Apple Silicon Macs, you can change the security settings and the allowed boot media settings.
- Share Disk (Apple Silicon Macs only): Can be used to transfer files from one computer to another. The equilant of Target Disk mode on Intel Macs.
- Terminal: Can be used for advanced troubleshooting, and it has the possiblity to enable/disable System Integrity Protection using csrutil.
File -> Choose Language: Switch between languages. This does not include the hello screen, which is normaly seen in the regular Language Chooser app.
Window -> Recovery Log (Command + L): view recovery log.
Country flag: switch between inputs.
Wi-Fi: switch between Wi-Fi networks
Apple logo -> Startup Disk: choose startup disk/boot to Target Disk Mode (only on Intel).
== watchOS ==
=== Booting to recovery mode ===
Double press the side button when in iBoot recovery mode.
=== Usage ===
Can update/restore an Apple Watch using an iPhone (not just the paired iPhone).
== audioOS and tvOS ==
Currently unknown.

@@ Line 77: / Line 77: @@
 In startup options, press and hold Command + D at the same time untill "Loading diagnostics..." appears on the screen.
 === Downloading Apple Silicon Diagnostics===
-The diagnostics are fetched from https://diagnostics.apple.com/api/v1/ast2-companion/public/services/assets. It is fetched as a JSON request. </br>
+The diagnostics/repair disk image for Mac are fetched from https://diagnostics.apple.com/api/v1/ast2-companion/public/services/assets. It is fetched as a JSON request. </br>
 The request looks like this:
 <syntaxhighlight>
-{"ProductVersion":"12.5.1","boardID":10,"chipID":24577,"OSVersion":"12.5.1"}
+{"ProductVersion":"13.0","boardID":10,"chipID":24577,"OSVersion":"13.0"}
 </syntaxhighlight>
 <syntaxhighlight>
@@ Line 91: / Line 91: @@
 <syntaxhighlight>
+{
-    "assetList": [{
+  "assetList": [
-        "version": "",
+      "partNumber": "012-22101",
-        "checkSum": "",
+      "version": "",
-        "reserved1": "",
+      "checkSum": "",
-        "reserved2": ""
+      "reserved1": "",
-        "audience": "FieldServiceDiskImage",
+      "type": "",
+}
 </syntaxhighlight>
 <syntaxhighlight>
-url: FieldService diagnostics image
+url: FieldService diagnostics/repair image
-audience: The name of the image
+audience: The image type
 imageName: file name
 partNumber: Apple's update ID for the package, from the software update catalog
 </syntaxhighlight>
 == watchOS ==
 === Booting to recovery mode ===

@@ Line 114: / Line 114: @@
 === Booting to recovery mode ===
 Double press the side button when in iBoot [[Recovery Mode]]. It is unknown if it is possible to boot to recoveryOS manually using button combinations at startup, just like on iOS, iPadOS, macOS and tvOS devices.
-[[Image:Applewatchseries7inrecm2.png |thumb|center|An Apple Watch Series 7 running in recoveryOS, recreated using an extracted graphic.]]
+[[Image:Applewatchultrainrecoveryos.png |thumb|center|An Apple Watch Ultra running in recoveryOS, recreated using an extracted graphic.]]
 === Usage ===
 Can update/restore an Apple Watch using an iPhone (not just the paired iPhone).

@@ Line 75: / Line 75: @@
 The only difference here is that the diagnostics request URL is http://osrecovery.apple.com/InstallationPayload/Diagnostics.
 === Booting Apple Silicon Diagnostics ===
-In the startup options, press and hold Command + D at the same time untill "Loading diagnostics..." appears on the screen.
+In startup options, press and hold Command + D at the same time untill "Loading diagnostics..." appears on the screen.
 === Downloading Apple Silicon Diagnostics===
 The diagnostics are fetched from https://diagnostics.apple.com/api/v1/ast2-companion/public/services/assets. It is fetched as a JSON request. </br>
 The request looks like this:
 <syntaxhighlight>
-{"ProductVersion": "12.5","boardID":10,"chipID":24577, "OSVersion":"12.5"}
+{"ProductVersion":"12.5.1","boardID":10,"chipID":24577,"OSVersion":"12.5.1"}
 </syntaxhighlight>
 <syntaxhighlight>
@@ Line 113: / Line 113: @@
 == watchOS ==
 === Booting to recovery mode ===
-Double press the side button when in iBoot [[Recovery Mode]].
+Double press the side button when in iBoot [[Recovery Mode]]. It is unknown if it is possible to boot to recoveryOS manually using button combinations at startup, just like on iOS, iPadOS, macOS and tvOS devices.
 [[Image:Applewatchseries7inrecm2.png |thumb|center|An Apple Watch Series 7 running in recoveryOS, recreated using an extracted graphic.]]
 === Usage ===
 Can update/restore an Apple Watch using an iPhone (not just the paired iPhone).
-== audioOS and tvOS ==
+== tvOS ==
 Currently unknown.

@@ Line 13: / Line 13: @@
 === What's included in recovery mode ===
 - Restore from Time Machine: restore from a Time Machine backup.</br>
-- Reinstall macOS: installs macOS full OTA from gdmf.apple.com (Pallas).</br>
+- Reinstall macOS: installs macOS InstallAssistant from the Software Update Catalog.</br>
 - Safari (minimal version, does not have the capability to play videos): User can use the internet to troubleshoot the Mac. The default home page is an HTML file which contains information about using recoveryOS.</br>
 - Disk Utility: Can be used to repair the disk using First Aid or erase the disk.</br>

@@ Line 61: / Line 61: @@
 AH - Some form of hash for the base system URL / content
 AT - BaseSystem URL token cookie (Passed in the next request as a cookie header)
-CU - chunklist URL (BaseSystem.chunklist
+CU - chunklist URL (BaseSystem.chunklist)
 CH - Chunklist URL hash / content
 CT - Chunklist URL token cookie (Passed in the next request as a cookie header)
@@ Line 119: / Line 119: @@
 == audioOS and tvOS ==
 Currently unknown.

← Older revision		Revision as of 20:17, 18 April 2022
Line 1:		Line 1:
		+	{{DISPLAYTITLE:recoveryOS}}
	'''recoveryOS''' is the recovery environment used in macOS, watchOS, tvOS and audioOS. </br>		'''recoveryOS''' is the recovery environment used in macOS, watchOS, tvOS and audioOS. </br>
	This is not the same as the iBoot [[Recovery Mode]] available on most Apple devices, as this type of recovery environment requires the device to be plugged into a computer.		This is not the same as the iBoot [[Recovery Mode]] available on most Apple devices, as this type of recovery environment requires the device to be plugged into a computer.

@@ Line 7: / Line 7: @@
 To boot to the local recovery mode, press Command + R at the same time during bootup until you see the Apple logo. To get the latest version of macOS (Internet Recovery), press Option (Alt) + Command + R at the same time until you see a spinning globe with text "Starting Internet Recovery. This may take a while.". You may need to choose a Wi-Fi network in order to download recoveryOS. To boot to the original macOS that your computer shipped with (or the closest version available), press Shift + Option (Alt) + Command + R at the same time until you see a spinning globe with text "Starting Internet Recovery. This may take a while.". You may need to choose a Wi-Fi network in order to download recoveryOS.
 ==== Apple Silicon based Macs ====
-Press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon). </br>
+Press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon)). </br>
-To boot to fallback recoveryOS (AKA System Recovery) double-press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon). The fallback recoveryOS doesn’t have the capability to change the system security state.
+To boot to fallback recoveryOS (AKA System Recovery) double-press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon)). The fallback recoveryOS doesn’t have the capability to change the system security state.
 === What's included in recovery mode ===
 - Restore from Time Machine: restore from a Time Machine backup.</br>

@@ Line 1: / Line 1: @@
-recoveryOS is the recovery environment used in macOS, watchOS, tvOS and audioOS. </br>
+'''recoveryOS''' is the recovery environment used in macOS, watchOS, tvOS and audioOS. </br>
 This is not the same as the iBoot [[Recovery Mode]] available on most Apple devices, as this type of recovery environment requires the device to be plugged into a computer.
 == macOS ==
-recoveryOS for macOS had its first introduction with Mac OS X Lion. At that time, Apple stopped selling Mac OS X through DVD's, and instead, they provided either USB sticks, or it could be downloaded through the Mac App Store. Apple also introduced a recovery environment, that in case a macOS installation is corrupted, it could recover itself by reinstalling macOS through the internet, without the need to reinstall macOS through a DVD.
+recoveryOS for macOS had its first introduction with Mac OS X Lion. At that time, Apple stopped selling Mac OS X through DVD's, and instead, they provided either USB sticks, or it could be downloaded through the Mac App Store. Apple also introduced a recovery environment, that in case a macOS installation is corrupted, it could be recovered by reinstalling macOS through the internet, without the need to reinstall macOS through a DVD. It also includes the tools that were used to be on the DVD (Terminal, Disk Utility, Startup Security Utility).
 === Booting to recovery mode ===
 ==== Intel based Macs (including T2 Macs) ====
 To boot to the local recovery mode, press Command + R at the same time during bootup until you see the Apple logo. To get the latest version of macOS (Internet Recovery), press Option (Alt) + Command + R at the same time until you see a spinning globe with text "Starting Internet Recovery. This may take a while.". You may need to choose a Wi-Fi network in order to download recoveryOS. To boot to the original macOS that your computer shipped with (or the closest version available), press Shift + Option (Alt) + Command + R at the same time until you see a spinning globe with text "Starting Internet Recovery. This may take a while.". You may need to choose a Wi-Fi network in order to download recoveryOS.
 ==== Apple Silicon based Macs ====
-Press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon).
+Press and hold the power button. You will see text "Countinue holding for startup options...". When you see the text "Loading startup options..." you may release the power button. Then choose Options (with the picture of a cogwheel (Software Update icon). </br>
 - Restore from Time Machine: restore from a Time Machine backup.</br>
-- Reinstall macOS: installs macOS through the internet.</br>
+- Reinstall macOS: installs macOS full OTA from gdmf.apple.com (Pallas).</br>
 - Safari (minimal version, does not have the capability to play videos): User can use the internet to troubleshoot the Mac. The default home page is an HTML file which contains information about using recoveryOS.</br>
 - Disk Utility: Can be used to repair the disk using First Aid or erase the disk.</br>
 There are more utilities that can be accesed through the menu bar by clicking Utilities: </br>
 - Startup Security Utility: On normal Intel Macs, it can be used to enable/disable the firmware password (only on regural Intel and T2 Macs). On T2/Apple Silicon Macs, you can change the security settings and the allowed boot media settings.</br>
-- Share Disk (Apple Silicon Macs only): Can be used to transfer files from one computer to another. The equilant of Target Disk mode on Intel Macs.</br>
+- Share Disk (Apple Silicon Macs only): Can be used to transfer files from one computer to another. The equivalent of Target Disk mode on Intel Macs.</br>
 - Terminal: Can be used for advanced troubleshooting, and it has the possiblity to enable/disable System Integrity Protection using csrutil.</br>
 File -> Choose Language: Switch between languages. This does not include the hello screen, which is normaly seen in the regular Language Chooser app.</br>
 Window -> Recovery Log (Command + L): view recovery log.</br>
-Country flag: switch between inputs.</br>
+Country flag: switch between keyboard inputs.</br>
 Wi-Fi: switch between Wi-Fi networks</br>
 Apple logo -> Startup Disk: choose startup disk/boot to Target Disk Mode (only on Intel).</br>
 == watchOS ==
 === Booting to recovery mode ===