Building & Installation

Build roothide Bootstrap from source or download pre-built releases

WARNING: By using this software, you take full responsibility for what you do with it. Any unofficial modifications to your device may cause irreparable damage. Refer to the FAQ for safe usage of this software.

Prerequisites

For Building from Source

  • macOS: You must have macOS to build, as you require Xcode from the App Store. Simply having Xcode Command Line Tools is insufficient.
  • Xcode: Latest version from the App Store
  • Git: For cloning the repository

For Installation

  • TrollStore: Version 2.0.9 or later (for enabling developer mode on-device)
  • Supported Device: iOS device running iOS 15.0-17.0 (see supported devices)
  • Bootstrap.tipa: Either built from source or downloaded from GitHub Releases

Building from Source (macOS)

If you have macOS and want to build roothide Bootstrap yourself, follow these steps:

Step 1: Install Theos with roothide Support

Update or install Theos with roothide support using the official installer:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"

Note: If you encounter errors from a previous Theos installation, remove Theos in its entirety before continuing.

Step 2: Clone the Repository

Clone the GitHub repository and enter the directory:

git clone https://github.com/roothide/Bootstrap.git
cd Bootstrap

Step 3: Build Bootstrap.tipa

Build the Bootstrap.tipa file using the Makefile:

make package

The built file will be located in the ./packages/ directory.

Step 4: Transfer to Device

Transfer Bootstrap.tipa from ./packages/ to your iOS device and install it with TrollStore.

Building with GitHub Actions (No macOS Required)

If you do not have access to macOS, you can build roothide Bootstrap using GitHub Actions. Refer to the FAQ in the Usage section for instructions on building with GitHub Actions instead.

This method allows you to build the bootstrap without needing a Mac, as the build process runs on GitHub's servers.

Downloading Pre-built Releases

If you prefer not to build from source, you can download pre-built releases from GitHub:

  1. Visit the GitHub Releases page
  2. Download the latest Bootstrap.tipa file
  3. Transfer the file to your iOS device
  4. Install using TrollStore

Recommended: Always use the latest stable release for the best experience and security updates.

Installation Steps

1. Install TrollStore

Before installing roothide Bootstrap, ensure you have TrollStore installed on your device. TrollStore version 2.0.9 or later is required for enabling developer mode on-device.

For TrollStore installation instructions, visit the TrollStore GitHub repository.

2. Transfer Bootstrap.tipa

Transfer the Bootstrap.tipa file to your iOS device. You can use:

  • AirDrop (if available)
  • Files app
  • iCloud Drive
  • Any file sharing method

3. Install with TrollStore

Open TrollStore on your device:

  1. Tap on the Bootstrap.tipa file
  2. Select "Install" in TrollStore
  3. Wait for the installation to complete

4. Launch Bootstrap

After installation, you should see the roothide Bootstrap app icon on your home screen. Launch it to begin configuration.

Installation Guides

For detailed step-by-step installation instructions, refer to these guides:

Troubleshooting

Build Issues

  • Theos Installation Errors: If you encounter errors from a previous Theos installation, completely remove Theos before reinstalling
  • Xcode Issues: Ensure you have the full Xcode app from the App Store, not just Command Line Tools
  • Build Failures: Check that you're using the latest version of Theos with roothide support

Installation Issues

  • TrollStore Version: Ensure you're using TrollStore 2.0.9 or later
  • iOS Version: Verify your device is running iOS 15.0-17.0
  • Device Compatibility: Check that your device is supported

For more troubleshooting help, visit our FAQ page or join our Discord server.

Next Steps

After successfully installing roothide Bootstrap:

  1. Read the Usage Guide to learn how to configure and use roothide Bootstrap
  2. Check the FAQ for common questions and answers
  3. Explore Developer Documentation if you want to create tweaks
  4. Join our Discord community for support