Troubleshooting StikDebug

Encountering issues with StikDebug? This guide covers common problems and solutions for connection errors, JIT not working, pairing file issues, and more.

Connection & Pairing Issues

StikDebug won't connect to my device

  • Check iloader: Ensure iloader is running on your computer (macOS, Windows, or Linux).
  • Verify pairing file: The pairing file must be placed in StikDebug. In iloader, go to "Manage Pairing File" → "Place" next to StikDebug.
  • USB vs. Wi-Fi: USB connection is more reliable. If using Wi-Fi, ensure your device and computer are on the same network.
  • Restart both: Close StikDebug and iloader, then reopen them.
  • Recreate pairing: After iOS updates or device resets, you may need to recreate the pairing file in iloader.

Pairing file expired or invalid

Pairing files can expire after iOS updates, restores, or device changes. Fix: Open iloader, click "Manage Pairing File," then "Place" next to StikDebug to generate a new pairing file. Transfer it to your device and import it in StikDebug.

Device not showing in iloader

  • Connect via USB and ensure the device is unlocked and trusted.
  • Install or update Apple Mobile Device drivers (Windows) or ensure usbmuxd is running (macOS/Linux).
  • Try a different USB cable or port.

JIT Not Working

JIT enabled but app still runs slowly

  • Ensure JIT was enabled before launching the app. Enable JIT in StikDebug, then launch your emulator or app.
  • Some apps need to be fully quit and relaunched after enabling JIT.
  • Check that your app is in the supported apps list.

JIT option grayed out or unavailable

Verify that StikDebug is connected (green status). If disconnected, fix pairing and connection first. Some apps may not support JIT on certain iOS versions.

App crashes when JIT is enabled

Try updating StikDebug and your target app to the latest versions. Check the Changelog for known issues. Report persistent crashes on GitHub Issues.

Installation & Launch Issues

StikDebug crashes on launch

  • Ensure you're on iOS 17.4 or later.
  • Trust the developer certificate: Settings → General → VPN & Device Management → tap your developer profile → Trust.
  • Reinstall StikDebug if the certificate expired (sideloaded apps typically need refreshing every 7 days with a free account).

Can't install StikDebug

Use AltStore, SideStore, or Sideloadly to sideload the IPA. Follow our Installation Guide. Ensure you have a working Apple ID and that your sideloading tool is configured correctly.

Profiles & Provisioning

Can't install provisioning profiles

  • Verify the profile file is valid (.mobileprovision).
  • Check that the profile matches your device and app.
  • Ensure you have enough storage space.

Still Having Issues?

If you've tried these steps and still have problems:

  • Visit our Support page for community resources
  • Join the Discord server for real-time help
  • Open an issue on GitHub with your iOS version, device model, StikDebug version, and steps to reproduce

Related Resources