If a build fails from a failed Theos install (code 8), you can wait until the next action runs or a workflow dispatch can be triggered.
Note: This repository has multiple branches. This is the auto-build branch. There is also a FAQ branch and branches for patch PRs.
DISCLAIMER: DO NOT use the builds in this repository if you DON'T know what you're doing. This is only for advanced users who need immediate access for testing. Refer to the building instructions in the FAQ for building.
This repository contains automatically built .tipa
files of the RootHide Bootstrap thats pulled from upstream and built hourly. This is the ONLY trustworthy repository that does this, until building is officially supported by the developer. If this helped you, feel free to leave a star.
You can download the .tipa
by clicking here. As this repository builds hourly, you may need to wait until the next build when a commit is pushed. Check the Actions tab to see when the last run was made. Building takes no more than six minutes.
A full featured bootstrap for iOS 14.0-17.0 A8-A17 & M1+M2. (Currently only tested tested on versions 15.0-17.0)
WARNING: By using this software, you take full responsibility for what you do with it. Any modification to your device may cause irreparable damage to your device. The Bootstrap currently does not work on iOS 17.0 for A15+ devices.
You'll need MacOS to build, as you require Xcode. Simply having Xcode Command Line Tools is not sufficient.
You will need Homebrew installed. If you don't have Homebrew installed, run the following command: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
Update your Theos to the RootHide build
bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"
This build of Theos is consistently updated.
-
Install make
brew install make
-
Clone the GitHub repository and enter directory
git clone https://github.com/RootHide/Bootstrap/ && cd Bootstrap
-
Build
Bootstrap.tipa
gmake -j$(sysctl -n hw.ncpu) package
-
Transfer
Bootstrap.tipa
from./packages/
to your device and install it with TrollStore!
The latest version of TrollStore is required as the bootstrap is built around the CoreTrust bug. Developer mode will need to be enabled to use this bootstrap. Follow this guide to enable developer mode. If you do not see the option to enable developer mode, you may need to first try sideloading an application (use AltStore or Sideloadly) and the option to enable developer mode will appear.
Once you open the Bootstrap app, press Bootstrap. This will install the necessary apps and files. You need to reboot to be able to uninstall the bootstrap.
You can add various sources to Sileo or Zebra, and install tweaks. You may need to convert tweaks to be Bootstrap compatible.
By default, tweaks are not injected into any apps. To enable tweak injection, click AppEnabler in the Bootstrap app, and toggle on an app you want to enable your tweaks in. You cannot inject into SpringBoard (com.apple.springboard) or Photos (com.apple.mobileslideshow) at the moment.
Normal rootless tweaks aren't out-of-the-box compatible with this bootstrap, so you'll need to develop them specifically to support it. You can refer to the developer documentation here.
Bootstrap can enable tweaks for almost all apps, but it currently does not yet support SpringBoard tweaks, meaning you cannot modify the homescreen, lockscreen, control center, statusbar, or anything related to the SpringBoard. While these tweaks are installable, you cannot enable SpringBoard in AppEnabler.
When installing a tweak, you might see a message saying 'Not Updated'. This tweak will need to be updated to support Bootstrap.
Install RootHide Patcher from Sileo. If you have problems installing, you're using Zebra, and need to switch to Sileo. When attempting to install a tweak, press 'Convert'. In the share sheet, press the Patcher app. When you convert a tweak to be Bootstrap compatible, you're given the option to directly convert simple tweaks or use rootless compat layer. If a tweak doesn't work with directly converting, try the rootless compat layer. You will need to install rootless-compat as a dependancy. Once the tweak is converted, press Ok and click Sileo in the share sheet. Press GET on the tweak and run the queue.
You will need to enable Settings (com.apple.Preferences) in AppEnabler to have tweak preferences show up in the Settings app, or download TweakSettings from CreatureSurvive. If an application disappears (like after a bootstrap uninstall) and is supposed to be on your homescreen, open TrollStore settings and press 'Rebuild Icon Cache'.
You can join our Discord for support or general talk here. There's a FAQ channel if you need any more information.
Huge thanks to these people, we couldn't have completed this project without their help!
- absidue: https://github.com/absidue
- akusio: https://twitter.com/akusio_rr
- Alfie: https://alfiecg.uk
- Amy While: http://github.com/elihwyma
- Barron: https://tweaksdev22.github.io
- BomberFish: https://twitter.com/bomberfish77
- bswbw: https://twitter.com/bswbw
- Capt Inc: http://github.com/captinc
- CKatri: https://procursus.social/@cameron
- Clarity: http://github.com/TheRealClarity
- Cryptic: http://github.com/Cryptiiiic
- dxcool223x: https://twitter.com/dxcool223x
- Dhinakg: http://github.com/dhinakg
- DuyKhanhTran: https://twitter.com/TranKha50277352
- dleovl: https://github.com/dleovl
- Elias Sfeir: https://twitter.com/eliassfeir1
- Ellie: https://twitter.com/elliessurviving
- EquationGroups: https://twitter.com/equationgroups
- Évelyne: http://github.com/evelyneee
- GeoSnOw: https://twitter.com/fce365
- G3n3sis: https://twitter.com/G3nNuk_e
- hayden: https://procursus.social/@hayden
- Huy Nguyen: https://twitter.com/little_34306
- iAdam1n: https://twitter.com/iAdam1n
- iarrays: https://iarrays.com
- iDownloadBlog: https://twitter.com/idownloadblog
- iExmo: https://twitter.com/iexmojailbreak
- iRaMzi: https://twitter.com/iramzi7
- Jonathan: https://twitter.com/jontelang
- Kevin: https://github.com/iodes
- kirb: http://github.com/kirb
- laileld: https://twitter.com/h_h_x_t
- Leptos: https://github.com/leptos-null
- limneos: https://twitter.com/limneos
- Lightmann: https://github.com/L1ghtmann
- Linus Henze: http://github.com/LinusHenze
- MasterMike: https://ios.cfw.guide
- Misty: https://twitter.com/miscmisty
- Muirey03: https://twitter.com/Muirey03
- Nathan: https://github.com/verygenericname
- Nebula: https://itsnebula.net
- niceios: https://twitter.com/niceios
- Nightwind: https://twitter.com/NightwindDev
- Nick Chan: https://nickchan.lol
- nzhaonan: https://twitter.com/nzhaonan
- omrkujman: https://twitter.com/omrkujman
- opa334: http://github.com/opa334
- onejailbreak: https://twitter.com/onejailbreak_
- Phuc Do: https://twitter.com/dobabaophuc
- PoomSmart: https://twitter.com/poomsmart
- ProcursusTeam: https://procursus.social/@team
- roothide: http://github.com/RootHide
- Sam Bingner: http://github.com/sbingner
- Shadow-: http://iosjb.top/
- Snail: https://twitter.com/somnusix
- SquidGesture: https://twitter.com/lclrc
- sourcelocation: http://github.com/sourcelocation
- SeanIsTethered: http://github.com/jailbreakmerebooted
- TheosTeam: https://theos.dev
- tigisoftware: https://twitter.com/tigisoftware
- tihmstar: https://twitter.com/tihmstar
- xina520: https://twitter.com/xina520
- xybp888: https://twitter.com/xybp888
- xsf1re: https://twitter.com/xsf1re
- yandevelop: https://twitter.com/yandevelop
- YourRepo: https://twitter.com/yourepo