Mirrors/Legacy-iOS-Kit
2
0
Fork 0
mirror of https://github.com/LukeZGD/Legacy-iOS-Kit.git synced 2025-02-20 02:12:45 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated Troubleshooting (markdown)

LukeeGD 2024-09-09 12:37:26 +08:00
parent 651fdc4cb5
commit 7578d74e36
1 changed files with 18 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
Troubleshooting.md

@ -1,10 +1,12 @@
## Common issues
- **If something in the process does not work for you:** try unplugging/replugging the device, switching between different USB ports/cables, also try USB 2.0 or 3.0 ports
- **If something in the process does not work for you:** try unplugging/replugging the device, switching between different USB ports/cables, also try USB 2 or 3 ports
- **IPSW file integrity** will be verified before restoring and/or creating custom IPSW (if custom IPSW is already created, this will be skipped) This is done to make sure that the IPSW is not corrupt or incomplete.
- **For users having issues with missing libraries/tools:** re-install dependencies by deleting the `firstrun` file in `resources`, then run the script again.
- **For users having issues with missing libraries/tools:** try to re-install dependencies by deleting the `firstrun` file in the `resources` folder, then run the script again.
- If your device is not being detected in normal mode, make sure to also trust the computer by selecting "Trust" at the pop-up.
- **macOS/Windows:** Double-check if the device is being detected by iTunes/Finder.
- **32-bit devices**: If SSH fails for you, [try these steps](#32-bit-devices) to make sure that SSH is successful
- Also try to restart your PC/Mac before retrying.
- If your device is having issues restoring, try deleting any/all existing custom IPSWs before retrying.
- **32-bit devices**: If the SSH step fails for you, [try these steps](#32-bit-devices) to make sure that SSH is successful
- Exit DFU Mode: Hold the TOP and HOME buttons of your device for about 15 seconds.
- Exit Recovery Mode: Run the script while the device is in recovery mode, select Downgrade Device, and select the option to exit recovery.
- **When opening an issue, send the FULL log. If you only send a partial log or not send a log at all, your issue will be dismissed and closed.**
@ -22,7 +24,7 @@
- All other options (full output of `--help`):
```
*** Legacy iOS Kit ***
*** Legacy iOS Kit ***
- Script by LukeZGD -
Usage: ./restore.sh [Options]
@ -43,13 +45,16 @@ For 32-bit devices compatible with restores/downgrades (see README):
--disable-bbupdate Disable bbupdate and enable dumping/stitching baseband
--gasgauge-patch Enable multipatch to get past "gas gauge" error (aka error 29 in iTunes)
--ipsw-hacktivate Enable hacktivation for creating IPSW (iPhone 2G/3G/3GS only)
--ipsw-verbose Enable verbose boot option (powdersn0w only)
--ipsw-verbose Enable verbose boot option (3GS and powdersn0w only)
--jailbreak Enable jailbreak option
--memory Enable memory option for creating IPSW
--pwned-recovery Assume that device is in pwned recovery mode
--skip-ibss Assume that pwned iBSS has already been sent to device
--skip-first Skip first restore and flash NOR IPSW only for powdersn0w 4.2.x and lower
For 64-bit checkm8 devices compatible with pwned restores:
--skip-blob Enable futurerestore skip blob option for OTA/onboard/factory blobs
* Default IPSW path: <script location>/<name of IPSW file>.ipsw
* Default SHSH path: <script location>/saved/shsh/<name of SHSH file>.shsh(2)
```
@ -84,15 +89,16 @@ For 32-bit devices compatible with restores/downgrades (see README):
- This is `sudo spctl --global-disable` on newer versions of macOS (11 and newer)
## Linux
- checkm8 is unfortunately very unreliable on Linux, you may have to try multiple times.
- checkm8 is unfortunately unreliable for A6/A7 devices on Linux, you may have to try multiple times.
- You may also try in a live USB
- You may have to get a machine running macOS to get your device to enter pwnDFU mode, or **[use iPwnder Lite for iOS](Pwning-Using-Another-iOS-Device)**
- For advanced users: Hackintosh and macOS KVM with USB passthrough should also work if set up properly
- If you have a PC with an AMD desktop CPU, this can significantly lower success rates of checkm8.
- You may have to get a machine running macOS to get your device to enter pwnDFU mode, or **[use iPwnder Lite for iOS](Pwning-Using-Another-iOS-Device)** to continue the process on Linux
- For advanced users: Hackintosh and macOS KVM with USB passthrough will also work if set up properly
## Windows
- **Windows users should use Legacy iOS Kit on Linux or macOS instead.**
- You can easily create an Ubuntu live USB with tools like [Rufus](https://rufus.ie/). Make sure to enable [Persistent Storage](https://www.linuxuprising.com/2019/08/rufus-creating-persistent-storage-live.html), or use another USB drive to store Legacy iOS Kit and its files.
- **Support for iPhone 4 and A7 devices is limited.** More details below.
- You can easily create an Ubuntu live USB with tools like [Rufus](https://rufus.ie/). Make sure to **enable [Persistent Storage](https://www.linuxuprising.com/2019/08/rufus-creating-persistent-storage-live.html)**, or use another USB drive to store Legacy iOS Kit and its files.
- **Support for iPhone 4 and older, and A7 devices is limited.** More details below.
- Windows users may encounter errors like `Unable to send APTicket` or `Unable to send iBEC` in the restore process.
- To exit recovery, run the script again and go to Other Utilities -> Exit Recovery Mode.
- Verify your iTunes version: Open iTunes -> Help -> About iTunes. Legacy iOS Kit can also detect your iTunes version.
@ -101,7 +107,7 @@ For 32-bit devices compatible with restores/downgrades (see README):
- After downgrading iTunes and/or attempting the fix, follow the procedure again. This time, it should get past the previous errors mentioned.
- If the troubleshooting steps do not work, consider creating a Linux live USB with persistent storage.
- [More troubleshooting steps here](https://ios.cfw.guide/futurerestore-help/)
- If you want to restore your iPhone 4 or A7 device on Windows, you need to first put the device in pwnDFU mode with signature checks disabled. Since entering pwnDFU mode is not supported on Windows, you need to use a Mac/Linux machine or another iOS device to do so. If your device is not in pwnDFU mode, the restore will NOT proceed.
- If you want to restore your iPhone 4 or older device or A7 device on Windows, you need to first put the device in pwnDFU mode with signature checks disabled. Since entering pwnDFU mode is not supported on Windows, you need to use a Mac/Linux machine or another iOS device to do so. If your device is not in pwnDFU mode, the restore will NOT proceed.
## A7 devices
- Do not use USB-C to lightning cables. Use USB-A to lightning cables only. You may use a USB-A to USB-C adapter if needed.
@ -143,6 +149,7 @@ For 32-bit devices compatible with restores/downgrades (see README):
- The custom IPSWs generated may have letter/s at the end of the file name. Here is a list of what each letter means.
- **A** - Stitched activation records
- **B** - Baseband update is disabled and stitched baseband enabled
- **D** - dead-bb flag is enabled
- **G** - gasgauge-patch flag is enabled
- **H** - Hacktivate option is enabled
- **J** - Jailbreak option is enabled