-
-
Notifications
You must be signed in to change notification settings - Fork 157
How to Use
LukeeGD edited this page Jun 29, 2025
·
142 revisions
- The procedure will be depending on your usage, operating system, and iOS device. Make sure that your setup is supported by the script. See the README for details before continuing.
- I (LukeZGD) will not be held responsible for any consequences or damages that may happen to your devices. Proceed at your own risk.
Legacy iOS Kit needs initial setup before usage. Please select your operating system.
Linux
-
Download Legacy iOS Kit here and extract the zip archive.
- You may also clone the repo:
git clone --filter=blob:none https://github.com/LukeZGD/Legacy-iOS-Kit
- For git clone, shallow clones (like
--depth 1
) are not supported. Do a blobless clone instead, as shown above.
- You may also clone the repo:
- Open a Terminal window.
- Start the script: Go to where the extracted files are located, drag
restore.sh
to the Terminal window, and press Enter/Return.
- On its first run, it will download and install dependencies. This will take some time depending on your Internet connection. When it's done, proceed to the next section.
macOS
-
Download Legacy iOS Kit here and extract the zip archive.
- You may also clone the repo:
git clone --filter=blob:none https://github.com/LukeZGD/Legacy-iOS-Kit
- For git clone, shallow clones (like
--depth 1
) are not supported. Do a blobless clone instead, as shown above.
- You may also clone the repo:
- Open a Terminal window.
- Install Xcode Command Line Tools by running this command:
xcode-select --install
- Install Homebrew or MacPorts.
- For macOS 12.7.6 and lower, only use MacPorts. Do not use Homebrew, they do not support older macOS versions.
- Install bash, curl, git from Homebrew or MacPorts.
- For Homebrew:
brew install bash curl git
- For MacPorts:
sudo port install bash curl git
- For OS X 10.11 only, also install cocoadialog:
sudo port install cocoadialog
- After the installation, exit the current Terminal window and open another one.
- For Homebrew:
- Start the script: Go to where the extracted files are located, drag
restore.sh
to the Terminal window, and press Enter/Return.
- On its first run, it will download and install dependencies. This will take some time depending on your Internet connection. When it's done, proceed to the next section.
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. Make sure to enable Persistent Storage, or use another USB drive to store Legacy iOS Kit and its files.
- Tutorial: https://ubuntu.com/tutorials/create-a-usb-stick-on-windows
- Make sure to set the Persistent partition size to enable Persistent Storage. You may set this to the maximum.
- For older systems, it is recommended to use a lightweight variant of Ubuntu like Linux Mint XFCE, Xubuntu, Lubuntu.
- For older versions of Rufus (3.22), do not use the latest Ubuntu since persistent storage will be broken. Use 22.04 (or Mint 21) instead.
Please select your usage.
- Restore/Downgrade a 32-bit device to iOS 8.4.1/6.1.3.
- Restore/Downgrade (and hacktivate) an iPhone 2G/3G/3GS/4, iPod touch 1/2/3, iPad 1.
- Restore/Downgrade an A7 device to iOS 10.3.3.
- Restore/Downgrade a 32-bit device to an iOS version I have SHSH blobs for.
- Restore/Downgrade a 32-bit device to other iOS versions using iOS 7 blobs. (powdersn0w)
- Restore/Downgrade a 64-bit device to an iOS version I have SHSH blobs for. (futurerestore)
- Jailbreak a 32-bit device on its current iOS version.
- Save onboard SHSH blobs of my current iOS version.
- Save SHSH blobs from Cydia servers. (32-bit devices only)
- Sideload apps to iOS device on Linux
- Activate iOS device
- Hacktivate old iPhone (activate without valid SIM card)
- Boot an SSH Ramdisk (32-bit and 64-bit devices)
- Install IPA files to jailbroken iOS device