/SSHRD_Script_Lite

A lite fork of SSH RAMDISK Script

Primary LanguageShellBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

SSHRD Lite

Features

  1. Make SSH ramdisk without connecting the iDevice.
  2. Lite version which only focuses to make SSH ramdisk and not like main fork.
  3. Other features you should find it yourself :).

Supported devices and limits

  • Windows users you need to get bash environment. You can get it by installing MSYS2, Cygwin, or Git-Bash
  • Linux and macOS users you already have bash environment.
  • A 64-bit iDevice supported by checkm8 (A7-A11).
  • Apple TV and M1/T2 requires manually replacing the "ssh.tar.gz" find it here.
  • Linux/Windows currently doesn't support making ramdisk for iOS 16.1 and above.

Preparing for installtion

Windows users:

  1. Install MSYS2
  2. Install git: pacman -S git
  3. Clone this repo and run.

Linux users:

  1. Update packages list: sudo apt-get update
  2. Install git: sudo apt install git
  3. Clone this repo and run.

macOS users:

  1. Install brew
  2. Install git: brew install git
  3. Clone this repo and run.

Clone this repo

git clone --recurse-submodules 'https://github.com/mast3rz3ro/SSHRD_Script_Lite' && chmod +x './SSHRD_Script_Lite/sshrd_lite.sh'

How to run

Find your correct product name: https://theapplewiki.com/wiki/Models

Please note that the same exact commands can be used on all platforms.

# Getting started

$ cd 'SSHRD_Script_Lite' # enter into working dir.
$ ./sshrd_lite.sh -h # print help info

### Some live examples ###

# make ramdisk for product type 'iphone8,2' with latest ios 15 available
$ './sshrd_lite.sh' -p 'iphone8,2' -s '15'

# make ramdisk for product type 'iphone8,2' with exact ios version.
$ './sshrd_lite.sh' -p 'iphone8,2' -s '15.7.9'

# make ramdisk for product type 'iphone8,2' with exact build version.
$ './sshrd_lite.sh' -p 'iphone8,2' -b '19H384'


### Extra options ###

# decrypt iboot files with gaster useful in case firmware keys not available yet.
$ './sshrd_lite.sh' -p 'iphone8,2' -b '19H384' -g

# repack only ramdisk.img image using img4tool
$ './sshrd_lite.sh' -p 'iphone8,2' -b '19H384' -z 2

# force patch iboot files using kairos
$ './sshrd_lite.sh' -p 'iphone8,2' -b '19H384' -y 1 # (if not used script will auto select best for you)

# force patch iboot files using iBoot64Patcher # (if not used script will auto select best for you)
$ './sshrd_lite.sh' -p 'iphone8,2' -b '19H384' -y 2

# connect device via ssh mode (used after sshrd booted)
$ './sshrd_lite.sh' -c

Important Notes

  • Do not run 'mount_filesystems' if you are running on iOS 11.x and lower.

  • On Linux, usbmuxd will have to be restarted. On most distros, it's as simple as these 2 commands in another terminal:

$ sudo systemctl stop usbmuxd
$ sudo usbmuxd -p -f

  • The original sshtars can be found here

  • For support please open new issue here

  • r/setupapp memebers don't miss the chance to join here

Credits

  • verygenericname The author of SSHRD Script
  • ifirmparser for preparing boot files and decryption keys
  • TRANTUAN for testing, thanks you so much :)
  • kairos iboot files patcher (supports patching the newer iOS e.g iOS 17.1)
  • firecore for providing an updated hfsplus for windows
  • tihmstar for pzb/original iBoot64Patcher/img4tool
  • xerub for img4lib and restored_external in the ramdisk
  • Cryptic for iBoot64Patcher fork
  • Nebula for a bunch of QOL fixes to this script
  • OpenAI for converting kerneldiff into C
  • Ploosh for KPlooshFinder a modern kernel patcher
  • libirecovery for the irecovery utility
  • gaster Another fork of checkm8 used to pwn dfu the device
  • sshrd_tools precompiled tools for all platforms