Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,6 @@ work
sshramdisk
.irecovery
*.log
nul
ramdisks/
sshrd-kk.sh
Binary file added MINGW64_NT-10.0-22631/KPlooshFinder
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/KPlooshFinder.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/gaster
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/gaster.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/hfsplus
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/hfsplus.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/iBoot64Patcher
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/iBoot64Patcher.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/img4
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/img4.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/img4tool
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/img4tool.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/iproxy
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/iproxy.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/irecovery
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/irecovery.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/jq
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/jq.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/kairos
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/kairos.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/kerneldiff
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/kerneldiff.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libcrypto-1_1-x64.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libcrypto-1_1.dll
Binary file not shown.
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libirecovery-1.0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libplist-2.0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libreadline8.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libtermcap-0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libusb-1.0-x64.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libusb-1.0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/libusbmuxd-2.0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-2.0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-crypto-1.1.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-curl-4.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-fragmentzip-0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-gcc_s-seh-1.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-general-0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-iconv-2.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-idn2-0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-img4tool-0.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-intl-8.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-lzfse.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-lzma-5.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-plist-2.0-4.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-psl-5.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-ssh2-1.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-ssl-1.1.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-stdc++-6.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-unistring-2.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-xml2-2.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/msys-z.dll
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/plget
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/plget.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/plistBuddy
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/plistutil
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/plistutil.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/pzb
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/pzb.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/sshpass
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/sshpass.exe
Binary file not shown.
Binary file added MINGW64_NT-10.0-22631/zlib1.dll
Binary file not shown.
127 changes: 82 additions & 45 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,104 @@
<h1 align="center">SSH Ramdisk Script</h1>
# SSH Ramdisk Script

<p align="center">
<a href="https://github.com/verygenericname/SSHRD_Script/graphs/contributors" target="_blank">
<img src="https://img.shields.io/github/contributors/verygenericname/SSHRD_Script.svg" alt="Contributors">
</a>
<a href="https://github.com/verygenericname/SSHRD_Script/commits/main" target="_blank">
<img src="https://img.shields.io/github/commit-activity/w/verygenericname/SSHRD_Script.svg" alt="Commits">
</a>
<img src="https://img.shields.io/github/stars/kagbontaen/SSHRD_Script?style=for-the-badge" />
<img src="https://img.shields.io/github/forks/kagbontaen/SSHRD_Script?style=for-the-badge" />
<img src="https://img.shields.io/github/issues/kagbontaen/SSHRD_Script?style=for-the-badge" />
<img src="https://img.shields.io/github/license/kagbontaen/SSHRD_Script?style=for-the-badge" />
</p>


<p align="center">
Create and boot a SSH ramdisk on checkm8 devices
<a href="https://github.com/kagbontaen/SSHRD_Script/graphs/contributors" target="_blank">
<img src="https://img.shields.io/github/contributors/kagbontaen/SSHRD_Script.svg" alt="Contributors">
</a>
<a href="https://github.com/kagbontaen/SSHRD_Script/commits/main" target="_blank">
<img src="https://img.shields.io/github/commit-activity/w/kagbontaen/SSHRD_Script.svg" alt="Commits">
</a>
</p>

<p align="center">Create and boot a SSH ramdisk on checkm8 devices</p>

---

# Prerequsites
# About this Fork
This fork differs from **verygenericname's** version in the following ways:
- **Supports offline IPSW files** for ramdisk creation.
- **Automatically saves a copy of generated ramdisk files** to:
```
ramdisk/<model>_<version>/
```

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

# Prerequisites
1. A computer running macOS or Linux
2. A checkm8-compatible device (A7–A11)

# Usage
1. Clone and enter the repository:
```bash
git clone https://github.com/kagbontaen/SSHRD_Script --recursive && cd SSHRD_Script
```
If previously cloned:
```bash
cd SSHRD_Script && git pull
```

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:
```
2. Run the ramdisk creation command:
```bash
./sshrd.sh <iOS version>
```
- The iOS version does **not** need to match the device, but SEP must be compatible.
- **Linux users:** iOS 16.1+ ramdisks cannot be created due to APFS changes; use 16.0 or lower.

3. Place your device into DFU mode.
- A11 devices: Recovery Mode → DFU.

4. Boot the SSH ramdisk:
```bash
./sshrd.sh boot
```

5. Connect via SSH:
```bash
./sshrd.sh ssh
```

6. Mount filesystems:
```bash
mount_filesystems
```
- `/var` mounts to `/mnt2`
- `/private/preboot` mounts to `/mnt6`
- **Do NOT run this on very old iOS versions.**

# Linux Notes
On Linux, `usbmuxd` must be restarted. Run these in another terminal:
```bash
sudo systemctl stop usbmuxd
sudo usbmuxd -p -f
```

# Other commands

- Reboot your device: `./sshrd.sh reboot`
- Erase all data from your device: `./sshrd.sh reset`
# Other Commands
- Reboot device: `./sshrd.sh reboot`
- Erase all data: `./sshrd.sh reset`
- Dump onboard SHSH blobs: `./sshrd.sh dump-blobs`
- Delete old SSH ramdisk: `./sshrd.sh clean`
- Delete old ramdisk: `./sshrd.sh clean`

# Other Stuff
---

# Other Resources
- [Reddit Post](https://www.reddit.com/r/jailbreak/comments/wgiye1/free_release_ssh_ramdisk_creator_for_iphones_ipad/)

# Credits
---

- [tihmstar](https://github.com/tihmstar) for pzb/original iBoot64Patcher/img4tool
- [xerub](https://github.com/xerub) for img4lib and restored_external in the ramdisk
- [Cryptic](https://github.com/Cryptiiiic) for iBoot64Patcher fork
- [opa334](https://github.com/opa334) for TrollStore
- [Nebula](https://github.com/itsnebulalol) for a bunch of QOL fixes to this script
- [OpenAI](https://chat.openai.com/chat) for converting [kerneldiff](https://github.com/mcg29/kerneldiff) into [C](https://github.com/verygenericname/kerneldiff_C)
- [Ploosh](https://github.com/plooshi) for KPlooshFinder
# Credits
- **remote-zip-viewer.py** (from the [remote-zip-downloader](https://github.com/kagbontaen/remote-zip-downloader) project)
- [tihmstar](https://github.com/tihmstar) — pzb, original iBoot64Patcher, img4tool
- [xerub](https://github.com/xerub) — img4lib, restored_external
- [Cryptic](https://github.com/Cryptiiiic) — iBoot64Patcher fork
- [opa334](https://github.com/opa334) — TrollStore
- [Nebula](https://github.com/itsnebulalol) — QOL fixes
- [OpenAI](https://chat.openai.com/chat) — kerneldiff → C port
- [Ploosh](https://github.com/plooshi) — KPlooshFinder
Binary file added Windows/KPlooshFinder
Binary file not shown.
Binary file added Windows/KPlooshFinder.exe
Binary file not shown.
Binary file added Windows/gaster
Binary file not shown.
Binary file added Windows/gaster.exe
Binary file not shown.
Binary file added Windows/hfsplus
Binary file not shown.
Binary file added Windows/hfsplus.exe
Binary file not shown.
Binary file added Windows/iBoot64Patcher
Binary file not shown.
Binary file added Windows/iBoot64Patcher.exe
Binary file not shown.
Binary file added Windows/img4
Binary file not shown.
Binary file added Windows/img4.exe
Binary file not shown.
Binary file added Windows/img4tool
Binary file not shown.
Binary file added Windows/img4tool.exe
Binary file not shown.
Binary file added Windows/iproxy
Binary file not shown.
Binary file added Windows/iproxy.exe
Binary file not shown.
Binary file added Windows/irecovery
Binary file not shown.
Binary file added Windows/irecovery.exe
Binary file not shown.
Binary file added Windows/jq
Binary file not shown.
Binary file added Windows/jq.exe
Binary file not shown.
Binary file added Windows/kairos
Binary file not shown.
Binary file added Windows/kairos.exe
Binary file not shown.
Binary file added Windows/kerneldiff
Binary file not shown.
Binary file added Windows/kerneldiff.exe
Binary file not shown.
Binary file added Windows/libcrypto-1_1-x64.dll
Binary file not shown.
Binary file added Windows/libcrypto-1_1.dll
Binary file not shown.
Binary file added Windows/libimobiledevice-glue-1.0.dll
Binary file not shown.
Binary file added Windows/libirecovery-1.0.dll
Binary file not shown.
Binary file added Windows/libplist-2.0.dll
Binary file not shown.
Binary file added Windows/libreadline8.dll
Binary file not shown.
Binary file added Windows/libtermcap-0.dll
Binary file not shown.
Binary file added Windows/libusb-1.0-x64.dll
Binary file not shown.
Binary file added Windows/libusb-1.0.dll
Binary file not shown.
Binary file added Windows/libusbmuxd-2.0.dll
Binary file not shown.
Binary file added Windows/msys-2.0.dll
Binary file not shown.
Binary file added Windows/msys-crypto-1.1.dll
Binary file not shown.
Binary file added Windows/msys-curl-4.dll
Binary file not shown.
Binary file added Windows/msys-fragmentzip-0.dll
Binary file not shown.
Binary file added Windows/msys-gcc_s-seh-1.dll
Binary file not shown.
Binary file added Windows/msys-general-0.dll
Binary file not shown.
Binary file added Windows/msys-iconv-2.dll
Binary file not shown.
Binary file added Windows/msys-idn2-0.dll
Binary file not shown.
Binary file added Windows/msys-img4tool-0.dll
Binary file not shown.
Binary file added Windows/msys-intl-8.dll
Binary file not shown.
Binary file added Windows/msys-lzfse.dll
Binary file not shown.
Binary file added Windows/msys-lzma-5.dll
Binary file not shown.
Binary file added Windows/msys-plist-2.0-4.dll
Binary file not shown.
Binary file added Windows/msys-psl-5.dll
Binary file not shown.
Binary file added Windows/msys-ssh2-1.dll
Binary file not shown.
Binary file added Windows/msys-ssl-1.1.dll
Binary file not shown.
Binary file added Windows/msys-stdc++-6.dll
Binary file not shown.
Binary file added Windows/msys-unistring-2.dll
Binary file not shown.
Binary file added Windows/msys-xml2-2.dll
Binary file not shown.
Binary file added Windows/msys-z.dll
Binary file not shown.
Binary file added Windows/plget
Binary file not shown.
Binary file added Windows/plget.exe
Binary file not shown.
Binary file added Windows/plistBuddy
Binary file not shown.
Binary file added Windows/plistutil
Binary file not shown.
Binary file added Windows/plistutil.exe
Binary file not shown.
Binary file added Windows/pzb
Binary file not shown.
Binary file added Windows/pzb.exe
Binary file not shown.
Binary file added Windows/sshpass
Binary file not shown.
Binary file added Windows/sshpass.exe
Binary file not shown.
Binary file added Windows/zlib1.dll
Binary file not shown.
Loading