Frequently Asked Questions

Find answers to common questions about roothide Bootstrap

General Questions

What is roothide Bootstrap?

roothide Bootstrap is a full-featured bootstrap for iOS 15.0-17.0 that uses the roothide framework. It provides a jailbreak-like experience without traditional root access, allowing you to customize your iOS device safely.

How is roothide Bootstrap different from traditional jailbreaks?

roothide Bootstrap uses injection-based techniques rather than direct system file modification. It doesn't inject tweaks system-wide by default - you must enable injection for each application individually. Additionally, injection into SpringBoard or daemons is not supported by design.

Is roothide Bootstrap safe to use?

While roothide Bootstrap is designed with safety in mind, any modification to your iOS device carries risks. Always follow best practices, use compatible tweaks, and refer to our usage guide for safe usage instructions.

What devices are supported?

roothide Bootstrap supports iOS devices with A8 through A17 Pro processors, as well as M1 and M2 chips. This includes iPhone 6 through iPhone 15 Pro Max, and various iPad models. See the supported devices list for complete details.

What iOS versions are supported?

roothide Bootstrap supports iOS 15.0 through iOS 17.0, including all minor versions and updates within this range.

Installation & Building

How do I install roothide Bootstrap?

roothide Bootstrap must be installed using TrollStore (version 2.0.9 or later). You can either build it from source (requires macOS) or download a pre-built release from GitHub Releases. See our building guide for detailed instructions.

Do I need macOS to build roothide Bootstrap?

To build from source on your local machine, yes - you need macOS with Xcode from the App Store. However, you can also build using GitHub Actions without macOS. Alternatively, you can download pre-built releases from GitHub.

Can I build roothide Bootstrap without macOS?

Yes! You can use GitHub Actions to build roothide Bootstrap without macOS. Refer to the GitHub Actions documentation or our building guide for instructions.

What version of TrollStore do I need?

You need TrollStore version 2.0.9 or later. This version is required for enabling developer mode on-device, which provides enhanced functionality.

I'm getting build errors. What should I do?

If you encounter errors from a previous Theos installation, completely remove Theos before reinstalling. Ensure you have the full Xcode app from the App Store (not just Command Line Tools). Check our troubleshooting section for more help.

Usage & Configuration

How do I enable tweak injection?

Open the roothide Bootstrap app, tap "App List", and toggle the switch next to each application you want to inject tweaks into. Changes take effect immediately, but you may need to restart the target application.

Why can't I inject tweaks into SpringBoard?

Injection into com.apple.springboard or daemons is not possible with roothide Bootstrap by design. This is a security and stability feature. If you need SpringBoard modifications, you'll need to use alternative methods or wait for future updates.

My tweaks aren't working. What's wrong?

First, ensure that tweak injection is enabled for the target application in App List. Second, verify that the tweak is compatible with roothide or has been converted using roothide Patcher. Finally, restart the target application after enabling injection.

How do I convert existing tweaks to work with roothide?

Use roothide Patcher to convert existing tweaks. The patcher can convert both rootful and rootless tweaks to be compatible with roothide Bootstrap.

Do I need to respring after installing tweaks?

Traditional resprings are not available in roothide Bootstrap. Instead, restart the target application after enabling tweak injection or installing new tweaks.

Tweaks & Compatibility

Which tweaks work with roothide Bootstrap?

Tweaks that have been specifically compiled for roothide or converted using roothide Patcher will work. Both rootful and rootless tweaks can be converted. Check the tweak's documentation or repository for roothide compatibility.

Can I use rootful tweaks?

Rootful tweaks need to be converted using roothide Patcher before they will work with roothide Bootstrap. The patcher can handle most rootful tweaks.

Can I use rootless tweaks?

Rootless tweaks also need to be converted using roothide Patcher. While they're closer to roothide's approach, they still require conversion for full compatibility.

Where can I find roothide-compatible tweaks?

Check repositories that specifically support roothide, or use roothide Patcher to convert existing tweaks. The roothide community is growing, and more developers are creating roothide-compatible tweaks.

How do I install tweaks?

Use package managers like Sileo or Zebra to install tweaks. These package managers support roothide Bootstrap and can handle .deb packages. You can also manually install .deb packages if needed.

Package Managers

Which package managers work with roothide Bootstrap?

Sileo and Zebra are both compatible with roothide Bootstrap. These are typically included with the bootstrap or can be installed separately.

How do I add repositories?

Open your package manager (Sileo or Zebra), navigate to Sources/Repositories, tap "Add Source" or "+", enter the repository URL, and confirm. The repository will be added and you can browse its packages.

My package manager isn't working. What should I do?

Ensure the package manager is properly installed. Try refreshing repository sources, verify repository URLs are correct, and check that you have an internet connection. If issues persist, reinstall the package manager.

Development

How do I develop tweaks for roothide?

You need to develop tweaks specifically for roothide using Theos with roothide support. See our developer documentation for detailed instructions and examples.

What's different about developing for roothide?

roothide tweaks use different paths and injection methods compared to traditional jailbreaks. You'll need Theos with roothide support and follow roothide-specific development practices. Check the developer documentation for details.

Where can I find developer documentation?

Visit our developer documentation page for comprehensive guides on developing roothide-compatible tweaks. You can also check the roothide GitHub organization for additional resources.

Troubleshooting

roothide Bootstrap won't install

Ensure you're using TrollStore 2.0.9 or later. Verify your iOS version is supported (15.0-17.0). Check that your device is compatible. If issues persist, try downloading a fresh copy of Bootstrap.tipa from GitHub Releases.

The app crashes or won't launch

Ensure your iOS version is supported. Try reinstalling roothide Bootstrap. Check that TrollStore is properly installed and up to date. If the issue persists, report it on GitHub with your device and iOS version information.

App List is empty or not showing apps

Ensure roothide Bootstrap has proper permissions. Try restarting the Bootstrap app. Verify your iOS version is supported. If the problem continues, reinstall roothide Bootstrap.

Tweaks cause apps to crash

Disable the problematic tweak immediately. Verify the tweak is compatible with roothide or has been properly converted. Check for updates to the tweak. Some tweaks may not be compatible with roothide's injection method.

Where can I get help?

For additional help, you can:

Additional Resources

For more information, check out these resources: