search

verygenericname / SSHRD_Script

Shell script that creates a ssh ramdisk
BSD 3-Clause "New" or "Revised" License
418 stars 164 forks source link

readme

SSH Ramdisk Script

Contributors Commits

Create and boot a SSH ramdisk on checkm8 devices

Prerequsites

  1. A computer running macOS/linux
  2. A checkm8 device (A7-A11)

Usage

  1. Clone and cd into this repository: git clone https://github.com/verygenericname/SSHRD_Script --recursive && cd SSHRD_Script
    • If you have cloned this before, run cd SSHRD_Script && git pull to pull new changes
  2. Run ./sshrd.sh <iOS version for ramdisk>, without the <>.
    • The iOS version doesn't have to be the version you're currently on, but it should be close enough, and SEP has to be compatible
    • If you're on Linux, you will not be able to make a ramdisk for 16.1+, please use something lower instead, like 16.0
      • This is due to ramdisks switching to APFS over HFS+, and another dmg library would have to be used
  3. Place your device into DFU mode
    • A11 users, go to recovery first, then DFU.
  4. Run ./sshrd.sh boot to boot the ramdisk
  5. Run ./sshrd.sh ssh to connect to SSH on your device
  6. Finally, to mount the filesystems, run mount_filesystems
    • /var is mounted to /mnt2 in the ssh session.
    • /private/preboot is mounted to /mnt6.
    • DO NOT RUN THIS IF THE DEVICE IS ON A REALLY OLD VERSION!!!!!!!
  7. Have fun!

Linux notes

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

Other commands

Other Stuff

Credits