Skip to content

Latest commit

 

History

History
227 lines (169 loc) · 8.62 KB

README.md

File metadata and controls

227 lines (169 loc) · 8.62 KB

pinera1n

Jailbreak method with Linux phone

This is a great way to make checkra1n portable, since it runs on PinePhone. You can use the latest GUI release of checkra1n, and you can operate it with the phone's touchscreen! It's called pinera1n because it was tested on PinePhone, which was inexpensive and very useful! Using apt-get or pacman on your Linux distribution will work. Recently, the default OS on PinePhone has become Manjaro, so you won't need to flash a new OS to use this on your PinePhone. However, I've also tested Arch and Mobian.

NOTE:Odysseyra1n also works. In addition, other Linux phones should work,too. This tool is called pinera1n because it first succeeded on a PinePhone. Please contact me on Twitter if your Linux distribution uses a different package handling system than apt-get or pacman.

SECOND NOTE:now only needs two commands to install dependencies and download checkra1n ,but actually it can merge two into one

Demo

Demo photo Demo photo Demo photo

What's new

Add quick setup to setup all dependencies and download cheeckra1n with less commands

Actually,it can merge two commands into one,check below

Hardware you'll need

  • A pinephone
  • USB-C docking bar with a USB-A to Lightning and USB-C charging port(Use USB-A to Lightning to connect the iPhone)
  • USB-A to Lightning cable
  • USB-C charging supply

Hardware you might need

  • Micro-SD card
  • a card reader

Supported Linux distributions(those that I have tested)

apt-get distributions

pacman distributions

Software you need

  • xterm(for resize terminal size)
  • usbmuxd(must need to connect iphone correctly)
  • Latest checkra1n release for linux arm64
  • a terminal program can set scale of terminal window(default program should work)

Software needed for odysseyra1n support

  • curl
  • libusbmuxd-tools(libusbmuxd)

Getting Started

You can select Quick setup or Manually setup

Quick setup

If you are flashing a different OS, please follow this tutorial.

Use this to setup all dependencies and download cheeckra1n with two commands

after run these commands,checkra1n will locate at Home and already got permission

  • for apt-get
sudo apt-get update && sudo apt-get -y upgrade && sudo apt-get install curl
sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/powenn/pinera1n/main/for-apt-get.sh)"

Or only one command instead

sudo apt-get update && sudo apt-get -y upgrade && sudo apt-get install curl && sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/powenn/pinera1n/main/for-apt-get.sh)"
  • for pacman
sudo pacman -Syu && sudo pacman -S curl
sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/powenn/pinera1n/main/for-pacman.sh)"

Or only one command instead

sudo pacman -Syu && sudo pacman -S curl && sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/powenn/pinera1n/main/for-pacman.sh)"

Manually setup

Please follow these steps carefully so you can use your PinePhone to jailbreak instead of a computer.

A. Flash os to emmc or sd card

If you are flashing a different OS, please follow this tutorial.

B. Install dependencies

  1. Perform available updates:

For apt-get:

sudo apt-get update
sudo apt-get upgrade

For pacman:

sudo pacman -Syu

Reboot your device.

  1. Install xterm and usbmuxd.

For apt-get:

sudo apt-get install xterm usbmuxd

For pacman

sudo pacman -S xterm usbmuxd
  1. If you want to use odysseyra1n, install curl and libusbmuxd-tools(libusbmuxd)

For apt-get

sudo apt-get install curl libusbmuxd-tools

For pacman

sudo pacman -S curl libusbmuxd
  1. Now, give checkra1n permission to run.
cd Downloads
chmod +x checkra1n

Exit terminal and re-open it.

  1. Set the terminal size and scale, so that we can run checkra1n with GUI. This will make it be more friendly to use.

Set the terminal scale to 50%, then enter this command:

resize -s 80 24

C. Run checkra1n

Connect your iPhone to your PinePhone via the docking bar. Make sure you charge your pinephone via docking bar for a stable connection. If your iPhone asks you to verify access to device, allow it.

Open and run checkra1n with this command:

default downloaded checkra1n loaction should in Downloads

cd Downloads/checkra1n
sudo ./checkra1n

If needed, change checkra1n's options (such as allowing untested versions). You should see the start button available. Follow checkra1n's instructions to complete the jaibreak.

If you're not using odysseyra1n yet and want to, keep going.Don't open the checkra1n loader app on your iPhone.

Odysseyra1n Conversion Instructions

Make sure you've already installed the optional dependencies for odysseyra1n. Then, enter this:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/coolstar/Odyssey-bootstrap/master/procursus-deploy-linux-macos.sh)"

This will require your iPhone's root password (which is alpine by default)

Once it finishes, you'll see Sileo on your iPhone, so you can install/update libhooker, RocketBootstrap, etc.

Advantages of pinera1n

  • Portable and friendly to operate with full GUI and touchscreen
  • You can still do more than jailbreak your iPhone on the PinePhone
  • It's not crazy expensive, and the PinePhone doesn't need to be jailbroken.
  • Setup instructions are simple, and it's straightfoward after setup.
  • checkra1n officially supports Linux on ARM, so it works better than Android would
  • You can use the latest release of checkra1n on pinephone immediately.
  • odysseyra1n works on pinephone
  • pinera1n supports multiple Linux distributions

Demo video

These are simple videos just showing what it looks like to use it:

Mobian

Manjaro

Tutorial video(odysseyra1n on mobian)

This video provides instructions in so that it's easier to follow.

My posts on Twitter

checkra1n successed on mobian

sideload with pinehphne test (using appsync)

cydia impactor 64bit on pinephone mobian with chroot(but cannot connect to iphone)

checkra1n successed on arch

checkra1n successed on manjaro

odysseyra1n successed on manjaro

My repo

My repo for jailbreak tweaks is here: powen00hsiao repo

Introduce pinephone

From wiki :The PinePhone is a smartphone developed by Hong Kong-based computer manufacturer Pine64, intended to allow the user to have full control over the device. Measures to ensure this are: running mainline Linux-based mobile operating systems, assembling the phone with screws, simplifying the disassembly for repairs and upgrades, and providing six kill switches/security switches for components of its hardware.The PinePhone ships with the Manjaro Linux-based operating system using the Plasma Mobile graphic interface, although other distributions can be installed by users.

CONTACT ME ON TWITTER FOR QUESTIONS!