Skip to content

Latest commit

 

History

History
97 lines (84 loc) · 5.49 KB

chapter-1.md

File metadata and controls

97 lines (84 loc) · 5.49 KB

Chapter 1 - Setting everything up

So you've read the intro and you've made it to the first chapter! Well done! Let's get started already!

What we'll do in this chapter

  • Install a terminal application
  • Install a file manager
  • Connect to our device using ssh

Setting up the terminal

So, a terminal is what allows us to communicate to our device, it's one of those black and white screens you normally associate with hackers (which you're becoming) well sort of...
It's necessary we have a terminal application otherwise, we won't be able to build our tweaks, nor will we be able to do other very important things like collaborating on GitHub (like Google Docs for coders,) or to test whether our bash scripts work. All in all, without a terminal, we can't do anything much.
The terminal app that we are going to install works even in the jailed state (the unjailbroken state) providing us more functionality than others (such as newterm2) that only work when you are jailbroken). The terminal we are going to install is called ish and it emulates a linux terminal on our device.

Steps to install ish

  1. Install iSH Shell from the AppStore or visit here
  2. Open ish, and you should see something like this iPhone:~# Note: you may change the theme to black if you wish by tapping the settings button in ish

You've done it, you've installed a terminal app on your device, time to move on

Ok, we need to install an application called filza as we will use this as our file manager.

Why not use the regular files app?

Apple's files app doesn't give us access to the full file system of our device. Which means we need to use filza if we want to navigate our device's filesystem. In addition, filza is very easy to use.

Steps to install filza

  1. Open your package manager (I'll be using sileo)
  2. Tap on sources
  3. Tap on edit
  4. Tap on add
  5. Insert the following url: https://data.tigisoftware.com/cydia/
  6. Add the source
  7. Go to the source
  8. Install filza (use normal filza and not the 64 bit version)
  9. Open filza, and tap on name (this will arrange everything alphabetically)

You've successfully installed filza, now time to connect to our device over ssh

Note: follow the jailbreak that applies to you:

Checkra1n (not odysseyra1n)

  1. Open ish
  2. Type apk add openssh
  3. After it finishes, type ssh localhost -p44
  4. It'll say the authenticity of xxx can't be established type yes
  5. It'll say root@localhost's password
  6. The default password is alpine
  7. It'll now say your device name followed by the word root
  8. You've successfully logged into your device using ssh

unc0ver, chimera and electra (devices not using the procursus bootstrap)

  1. Go to halo_michael's repo: (https://halo-michael.github.io/repo) and install localssh
  2. Install openssh (unc0ver users go to the bingner repo, electra and chimera jailbreak users go to the chimera repo)
  3. Open ish
  4. Type apk add openssh
  5. After it finishes, type ssh localhost -p2222
  6. It'll say the authenticity of xxx can't be established type yes
  7. It'll say root@localhost password
  8. The default password is alpine
  9. It'll now say your device name followed by the word root
  10. You've successfully logged into your device using ssh

procursus based jailbreaks (odyssey, odysseyra1n)

  1. Install openssh (go to the procursus repo)
  2. Open ish
  3. Type apk add openssh
  4. After it finishes, type ssh localhost -p2222
  5. It'll say the authenticity of xxx can't be established type yes
  6. It'll say root@localhost password
  7. The default password is alpine
  8. It'll now say your device name followed by the word root
  9. You've successfully logged into your device using ssh

Connecting from a laptop over wifi

  1. Install openssh (you will need to know how to install this for your own os)
  2. Open terminal
  3. On the device, install openssh (see above for jailbreak specific instructions)
  4. Open settings, > tap the I icon next to the wifi you are connected and remember the IP address, for example, 192.168.0.24 (yours might be different)
  5. Type ssh root@your IP address note: checkra1n (not odysseyra1n) users type ssh root@your IP address -p44 instead
  6. It'll say the authenticity of xxx can't be established type yes
  7. It'll say root@your IP address password: (mine is root@demhademha)
  8. The default password is alpine
  9. It'll now say your device name followed by the word root
  10. You've successfully logged into your device using ssh

Using ssh over usb

  1. Install libimobiledevice through your package manager, or compile it yourself
  2. Connect your device via usb (make sure you don't have any other devices connected)
  3. Open terminal
  4. Type iproxy 2222 2222 note: checkra1n (not odysseyra1n) users type iproxy 2222 44 instead
  5. Open a new terminal and type ssh root@localhost -p2222
  6. It'll say the authenticity of xxx can't be established type yes
  7. It'll say root@localhost's password, the default is alpine

Few, we’ve completed getting ish, installing filza and you now know how to connect using ssh! Next up, we will learn more about using the Terminal.

When you are ready, you can head over to Chapter 2

Remember, you can join our Discord server