Troubleshooting roothide Bootstrap

Fix common installation, build, and tweak issues.

Installation Issues

Bootstrap will not install or install fails

  • Ensure TrollStore is installed and is version 2.0.9 or later.
  • Confirm your device and iOS version are supported (iOS 15.0-17.0).
  • Re-download Bootstrap.tipa from GitHub releases in case the file was corrupted.
  • Try installing again from TrollStore; if it still fails, check Discord or GitHub issues for your specific iOS version.

TrollStore not installed or wrong version

roothide Bootstrap requires TrollStore 2.0.9 or later. Install or update TrollStore using the official method for your iOS version. See TrollStore and roothide Bootstrap.

Build Issues (from source)

Theos or build errors

  • If you have an existing Theos install, remove it completely before installing Theos with roothide support.
  • Use the official roothide Theos installer from the Building guide.
  • You must have the full Xcode app from the App Store (Command Line Tools alone are not enough).
  • Build from a clean clone: git clone the Bootstrap repo then make package.

Tweak and Injection Issues

Tweaks not working in an app

  • Confirm tweak injection is enabled for that app in the Bootstrap app App List.
  • Ensure the tweak is roothide-compatible or was converted with roothide Patcher.
  • Force-quit and reopen the target app after enabling injection.
  • Respring is not used in roothide; restarting the app is the correct way to apply injection changes.

App List empty or not showing apps

  • Grant the Bootstrap app any requested permissions.
  • Restart the Bootstrap app and check again.
  • Verify your iOS version is supported; reinstall the bootstrap if the problem persists.

App crashes when using a tweak

Disable the tweak (or disable injection for that app), then remove or update the tweak. Some tweaks are incompatible with roothide; check for a roothide-compatible version or use Patcher and test carefully.

Getting More Help

  • FAQ - Common questions and answers
  • Discord Server - Community support
  • GitHub Issues - Bug reports (include device, iOS version, and steps to reproduce)

Related Pages