Ra1nbox - The portable checkra1n jailbreak solution


The portable checkra1n jailbreak solution

If you can read this, then your browser sucks. What are you even doing here?...

Want to jailbreak on-the-go? Now you can!

Ever wanted to jailbreak on-the-go without a PC, while out camping in the middle of nowhere? Or when riding the bus to work?
With checkra1n you're stuck to a computer to be able to jailbreak. But using this solution, you can take a tiny computer with you to jailbreak wherever you are. Even when somewhere remote, you'd only need a powerbank or other USB type power supply.

Using a NanoPi Neo2 single-board computer chip, a display and an aluminum case with 3 brass buttons loaded with this software combined with the checkra1n software, you can jailbreak anywhere. The Ra1nbox software powers the display and takes care of the checkra1n part of the software.
This makes this an all-in-one on-the-go type solution.

More information on Reddit

Build yourself

In order to build this yourself, you need to buy all the parts on the parts list. Once you have everything, head over to the installation instructions.

Parts list

Below are the parts needed to build your own Ra1nbox:

Item Price Supplier / Link Notes
NanoPi Neo2 - starter kit

Includes all needed items:
- NanoHat OLED
- NanoPi metal case + heatsink + foot pads
- Thermal pads
- Micro SD Card 16GB
- Micro-USB cable
€55,00 Aliexpress supplier #1

Aliexpress supplier #2

Aliexpress supplier #3

Aliexpress supplier #4
(Black version)

Aliexpress supplier #5
(Black version)

(Black version)

512MB or 1GB?
The 1GB ram version is actually the "NanoPi Neo2 Black", see below. There is no performance increase between 512MB < - > 1GB.

NanoPi Neo2 Black:
The "black" version comes with 1GB of ram, has an added eMMC memory chip and the color of the PCB is BLACK instead of green. This board has been tested and is supported as well.

NanoPi Neo2-LTS:
"NanoPi Neo2" is also known as "NanoPi Neo2-LTS" (LTS = Long Term Support), both are the same and thus supported.

NanoPi Neo:
The "NanoPi Neo (1)" is not supported.
NanoPi Neo2 €25,00 See above notes and links
NanoHat OLED €10,00 Aliexpress supplier #1 See above notes and links
NanoPi metal case + heatsink + foot pads €? See above notes and links
Thermal pads €2 Aliexpress supplier #1

Cheap local supplier is advised
Micro SD Card 16GB €10 Cheap local supplier is advised 16GB or higher, class 10 recommended
Micro-USB cable €5 Cheap local supplier is advised

Prices exclude shipping

Installation instructions

Follow these instructions to setup your Ra1nbox using Windows, MacOS or a Linux computer. A computer is needed one-time only for the setup. After that, you don't need a PC anymore.

Recommended software for Windows:
Recommended software for MacOS/Linux:
  • Builtin Terminal for SSH connection
  • balenaEtcher for SD card writing

  1. Download Armbian - Buster minimal
    (bottom of the page)
  2. Extract and flash image to SD card
    Use Etcher / PiFiller or any other program you can find using Google
  3. Put the SD card in your NanoPi Neo2 device, find the IP address of your device and connect with SSH
    ssh [email protected]

    Log in in with username root and default password 1234, after logging in change the password to ra1nbox

    When being asked to provide a username after changing the default root password, please enter ra1nbox as username and ra1nbox as password.

    Press enter several times when Armbian starts to behave like your overly attached girlfriend and asks you silly questions like "What is your room number" ;-) Just leave it blank/default and do not answer it! (protip: don't do that with your actual girlfriend though)

  4. Update / Upgrade
    sudo apt-get update
    sudo apt-get upgrade
  5. Install i2c tools, GIT, pillow, smbus, pip and armbian-config
    sudo apt-get install i2c-tools git vim armbian-config python3-dev python3-pil python3-smbus python3-pip python3-serial
  6. Turn on I2C module loading
    sudo armbian-config
    Menu System > Hardware > enable i2c0
    Save and reboot
  7. Login using username root and password ra1nbox
    ssh [email protected]
  8. See i2c works and check if output is i2c-0
    sudo i2cdetect -l

    If you don't see i2c-0 as output, you've fucked something up. Go back and try above steps again :)

  9. Install needed libraries
    sudo pip3 install --upgrade setuptools
    sudo pip3 install sh
    sudo pip3 install psutil
  10. Install checkra1n dependancies
    sudo apt install libc6 libncurses5 libpango-1.0-0 libpangocairo-1.0-0 libpangoft2-1.0-0 libatk1.0-0 libgdk-pixbuf2.0-0 libglib2.0-0 libfontconfig1 libfreetype6 libgtk-3-0 libusb-1.0-0 libplist3 usbmuxd ideviceinstaller python-imobiledevice libimobiledevice-utils python-plist ifuse libusbmuxd-tools
  11. Create a new file by editing /usr/local/bin/oled-start
    vim /usr/local/bin/oled-start

    Then paste all of below contents

    if [ -f "$FILE" ]; then
        # Unzip update to Ra1nbox folder and force overwrite existing files
        unzip -o $FILE -d /home/ra1nbox/ra1nbox
        # Remove update file
        rm -f $FILE
    # Start Ra1nbox software
    cd /home/ra1nbox/ra1nbox
  12. Add yourself to the root group and correct rights on oled-start to be sure
    usermod -a ra1nbox -G root
    chmod 755 /usr/local/bin/oled-start
  13. Add to rc.local file to make sure everything auto-starts at boot
    sed -i -e '$i \/usr/local/bin/oled-start\n' /etc/rc.local
  14. Download the latest version of the Ra1nbox software to your NanoPi Neo 2
    mkdir /home/ra1nbox/ra1nbox
    wget https://updates.ra1nbox.com/download -O /home/ra1nbox/ra1nbox/update.zip

    If you get a connection error, 403 forbidden or anything related to that. Please manually download the latest update and upload it manually by using SFTP to directory "/home/ra1nbox/ra1nbox/".

  15. Reboot Ra1nbox and you should be ready to go!
    sudo reboot

    Note: first boot time is about 1 to 2 minutes! After that it shouldn't be more than 30 seconds. If you don't see the Ra1nbox logo after about 2 minutes or the screen doesn't function correctly, please read the FAQ.

Thank you so much for using Ra1nbox!
Hopefully you've got a fully working Ra1nbox device now thanks to my software, checkra1n software and written and/or video instructions made by me.

As a thank you, please buy me a beer or consider a small donation
>>>>>>>>>> Thanks once again! <<<<<<<<<<

Buy me a beer!

Installation service

If you don't have the experience working with Linux, NanoPi or technical stuff in general or rather would like to have a plug-and-play solution, this is the best option for you.


What you will be paying for:
- I will buy all the parts required for Ra1nbox to work
- The metal case will be assembled by me
- Linux Raspbian OS will be installed and configured
- All the connections to the display will be setup
- All the required software will be installed and configured
- Shipping a ready-to-go Jailbreak device to your doorstep
- No PC needed!

Not included:
- Micro-USB cable
- Lightning cable
- iPhone :)


  • What do the menu options do?
    • Verbose mode
      Boot the iPhone into verbose boot mode using checkra1n
    • Safe mode
      Jailbroken, but prevents tweaks from loading
    • Auto shutdown
      After jailbreaking, auto shutdown the Ra1nbox. Otherwise return home. Turn this option off if you want to jailbreak multiple devices
    • System info
      Shows Ra1nbox version, checkra1n version, CPU load, CPU temperature, IP address
    • Check for updates
      See the Updates section

  • The Ra1nbox hangs during the jailbreak process!
    Can't do much about that since checkra1n is still in beta. But in order to safely shutdown, 'force quit' option was added in Ra1nbox version 1.1:
    During the checkra1n process, remove the lightning cable and then press F3 3x times to force quit checkra1n and go back to the main menu. Be sure to restart the Ra1nbox before trying a new jailbreak attempt!

  • My screen stays black after updating
    Make sure you've added the ra1nbox user to the root group, then restart the ra1nbox:
    usermod -a ra1nbox -G root
  • The display doesn't work or doesn't work correctly
    You probably missed one of the commands. First thing to do is to run the history command:
    Using this command, you can see which commands you've run before. And thus make sure you've followed every step. If you're sure, also check the output of the /usr/local/bin/oled-start file is the same as in the instructions above, step #11:
    cat /usr/local/bin/oled-start
    If the output you get here is not the same as in step #11. Run step #11 again, either editing the file or removing (rm /usr/local/bin/oled-start) the file first. If the display still doesn't work, run command #12 again to make sure you have the correct rights.
    If after all of those steps, the display still doesn't work. It's best to start over from step #1. Make sure you follow all instuctions exactly like it's being shown in the video tutorial.

  • After the jailbreaking starts, the display/jailbreak stays in a loop (and optionally reboots iPhone into normal mode)
    Try different cable


The idea is that if checkra1n comes with an update, I'll provide an updated package for all Ra1nbox users.
This makes updating the Ra1nbox really easy:

  1. Connect the Ra1nbox to an ethernet cable
  2. Go to the Options menu and then select Check for updates
  3. If an update is available, it's shown on the screen including a small changelog. Select Yes to auto-update on the next reboot or No to cancel
  • 1.1 Added option to force quit checkra1n (4 March 2020)

    Some users reported that sometimes the jailbreak process hangs for whatever reason. This makes the Options and Safe-exit menu unavailable. The only way to shut down was to remove the power cable, meaning the SD card could be corrupted.
    To use the force quit mode: remove the lightning cable and press F3 3x times during the checkra1n process. The Ra1nbox will restart to the main screen so you can now safely shutdown. In order to jailbreak again, a minimum of 1 reboot is required after using the force shutdown function!

  • 1.0 Initial release
    Based on checkra1n 0.9.8
Manual update/downgrade:

If you want to manually upgrade or downgrade for whatever reason, follow these instructions:

  • Download checkra1n arm64 version from the checkra1n website
  • Connect to your Ra1nbox using either SFTP or WGET method listed below:
  • SFTP (easiest method): Use an FTP client like Filezilla and connect using SFTP method with above credentials
  • WGET: Make a SSH connection using Terminal on MacOS or for example Putty on Windows
  • Browse to the /home/ra1nbox/ra1nbox folder and replace the existing checkra1n file

Known issues

  • iPhone X requires verbose mode to be set in order to successfully jailbreak. This is a known checkra1n issue.
  • Touchscreen does not work on some occasions ("swipe up to unlock" etc.). Restart phone in normal mode and re-jailbreak.


Got any questions related to the Ra1nbox project? Contact me using one of the methods below.
Note: I do not provide first line of support. In other words; ask the community for help. If you really can't figure out the solution, contact me so I can see how/if I can help.


You are free to alter my software as long as you refer to this website as the original source. Do not redistribute and/or sell my software without written consent.
For business inquiries or to discuss the possibility to distribute and/or sell my software as a reseller, contact me using the methods below.
You are free to publish Ra1nbox related images on your website without changing anything as long as you refer to this website as the original source. Other than changing the image(s) dimensions, do not add, alter or in any other way change the image(s).