Skip to content

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.

Initial Setup

Legacy iOS Kit needs initial setup before usage. Please select your operating system.

Linux
  1. 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.
  2. Open a Terminal window.
  3. Start the script: Go to where the extracted files are located, drag restore.sh to the Terminal window, and press Enter/Return.

image

  1. 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
  1. 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.
  2. Open a Terminal window.
  3. Install Xcode Command Line Tools by running this command: xcode-select --install
  4. 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.
  5. 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.
  6. Start the script: Go to where the extracted files are located, drag restore.sh to the Terminal window, and press Enter/Return.

image

  1. 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.

Usage

Please select your usage.

More info about the options

Clone this wiki locally