Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
c464ccb
Update windows.mdx
CelloSerenity Jun 12, 2025
0494bc0
Merge branch 'SideStore:main' into main
CelloSerenity Jun 12, 2025
7c7ffca
Merge branch 'SideStore:main' into main
CelloSerenity Jun 15, 2025
1a9bf7b
Update anisette.mdx
CelloSerenity Jun 15, 2025
113bc9c
Merge branch 'SideStore:main' into main
CelloSerenity Jun 24, 2025
9a6849a
Update docusaurus.config.js
CelloSerenity Jun 24, 2025
f6ce00e
Update TRANSLATION_GUIDE.md
CelloSerenity Jun 24, 2025
7de37f9
Update common-issues.mdx
CelloSerenity Jun 24, 2025
fee5809
Update error-codes.mdx
CelloSerenity Jun 24, 2025
90cf9d4
Update error-codes.mdx
CelloSerenity Jun 24, 2025
e6df307
Update linux.mdx
CelloSerenity Jun 29, 2025
5ad4d7e
Update pairing-file.mdx
CelloSerenity Jun 29, 2025
2fba0de
Update linux.mdx
CelloSerenity Jun 29, 2025
038cbb9
Update linux.mdx
CelloSerenity Jun 29, 2025
f21f5d3
Update error-codes.mdx
CelloSerenity Jun 29, 2025
864c659
Update post-install.mdx
CelloSerenity Jun 29, 2025
6db0eea
Update faq.mdx
CelloSerenity Jun 29, 2025
07294b3
Update release-notes.mdx
CelloSerenity Jul 1, 2025
a725eba
Update jit.mdx
CelloSerenity Jul 1, 2025
a0bba13
Update faq.mdx
CelloSerenity Jul 1, 2025
164600f
Update faq.mdx
CelloSerenity Jul 1, 2025
5b5368d
Merge branch 'SideStore:main' into main
CelloSerenity Jul 5, 2025
fda2614
Update intro.mdx
CelloSerenity Jul 5, 2025
df67ada
Update prerequisites.mdx
CelloSerenity Jul 5, 2025
1ec3c72
Update prerequisites.mdx
CelloSerenity Jul 15, 2025
f65c9b6
Update intro.mdx
CelloSerenity Jul 15, 2025
c9b93d5
Update common-issues.mdx
CelloSerenity Jul 15, 2025
50de62c
Update troubleshooting.mdx
CelloSerenity Jul 15, 2025
a7d0d04
Update common-issues.mdx
CelloSerenity Jul 15, 2025
bf52e28
Update error-codes.mdx
CelloSerenity Jul 15, 2025
fdabb07
Update jit.mdx
CelloSerenity Jul 15, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 12 additions & 14 deletions docs/advanced/jit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,41 +4,39 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps
---

:::note
iOS 26 has broken JIT once again. A fix is in the works.
iOS 26 has broken JIT once again. A fix will be released to StikDebug after the iPhone 17 releases.

There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more. This tutorial will cover the use of StikDebug (formerly StikJIT), as it is the method we currently recommend. For more information, consult the [official StikDebug pairing guide](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md).

As an alternative, SideStore 0.6.2 includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN with either Wi-Fi connected or Airplane Mode enabled, then navigate to "My Apps," longpress the app you wish to enable JIT for, and tap "enable JIT".
:::

## Prerequisites
* An iDevice on iOS/iPadOS 17.4 and up to iOS/iPadOS 18.5, excluding 18.4b1. If you are on 17.0-17.3, you must use an alternative such as [SideJITServer](https://github.com/nythepegasus/SideJITServer). Versions newer than 18.5 are currently unsupported.
* At least 1 free app slot (if sideloading).
* An iDevice running iOS/iPadOS 17.4-18.6, excluding 18.4b1. If you are on 17.0-17.3, you must use an alternative such as [SideJITServer](https://github.com/nythepegasus/SideJITServer). As stated above, versions newer than 18.6 are currently unsupported.

## StikDebug installation with Apple App Store (Doesn't require an app slot)
## StikDebug installation with Apple App Store

1. **Install StikDebug**
Install StikDebug from the [Apple App Store](https://apps.apple.com/us/app/stikdebug/id6744045754). Something nice- the VPN present in StikDebug is similar to the one used in SideStore, meaning you use it to install and refresh apps as well.
Install StikDebug from the [Apple App Store](https://apps.apple.com/us/app/stikdebug/id6744045754).
:::note Something nice- the VPN present in StikDebug is similar to the one used in SideStore, meaning you use it to install and refresh apps in SideStore as well, similar to StosVPN.
:::

2. **Installation procedures:**
Follow the standard installation procedures in the usage guide below.


### Standard installation procedures:

1. **Enable VPN:**
Start by activating StosVPN (if sideloading StikDebug) or the built-in VPN in the official StikDebug.
1. **Upload the Pairing File:**
Open and close StikDebug to build the app's folder in files, then import the same **pairing file** you use for SideStore using idevice pair. For more information on this process, see [here](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md).

2. **Upload the Pairing File:**
Import the same **pairing file** you use for SideStore using iDevicePair. For more information on obtaining this pairing file, see [here](/docs/installation/pairing-file).
2. **Mount the DDI:**
Open StikDebug with Wi-Fi and the VPN connected and the pairing file imported, then close it and reopen it. This mounts the DDI and must be performed every time you restart your idevice.

## To enable JIT:

1. **Enable VPN:**
Start by activating the built-in VPN in StikDebug.
Start by opening StikDebug on Wi-Fi or with cellular data enabled to activate the built-in VPN. Now, if using cellular data, enable Airplane Mode and reopen the app with the VPN still enabled.

2. **Activate JIT:**
Select the “Enable JIT” button and select an app from the list (must be sideloaded with proper entitlements to appear in the list) to attach a debugger/activate JIT functionality.

### Offline JIT Enabling
To enable JIT offline, activate StosVPN (if sideloading) or the StikDebug VPN. Then, turn both Wi-Fi and Mobile Data OFF when you launch StikDebug (use Airplane Mode). You can then enable JIT as normal.
Select the “Connect by App” button and select an app from the list (must be sideloaded with proper entitlements to appear in the list) to attach a debugger and activate JIT functionality.
25 changes: 13 additions & 12 deletions docs/troubleshooting/common-issues.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,26 +16,27 @@ This page is currently a work in progress. The information provided should be ac
Connection issues or an invalid pairing file.
#### Resolution
1. Attempt to reconnect
2. Generate and import a new pairing file using idevice pair. See our [Pairing File instructions](/docs/installation/pairing-file) for details.
2. Generate and import a new pairing file using idevice pair. See our [Pairing File instructions](/docs/installation/pairing-file) for details

### No Wi-Fi or VPN Connection
#### Cause
Connection issues with the minimuxer service.
#### Resolution
1. If using WireGuard, switch to StosVPN
2. Turn off any DNS-blocking servers
2. Try again (spamming the button often helps)
3. Restart SideStore
4. Restart StosVPN
5. Generate and import a new pairing file using idevice pair. See our [Pairing File instructions](/docs/installation/pairing-file) for details.
5. Regenerate and import a new pairing file using idevice pair. See our [Pairing File instructions](/docs/installation/pairing-file) for details

### SideStore Hangs Halfway Through Installation
### SideStore Hangs Partway Through Installation
#### Cause
Cache issues.
Cache or protocol issues.
#### Resolution
1. Restart SideStore
1. Update SideStore, if applicable. Otherwise, just restart
2. Clear Cache
3. Change Anisette Server
4. In servers- reset adi.pb, then sign out of SideStore and sign back in.
4. In servers- reset adi.pb, then sign out of SideStore and sign back in
5. Restart device
6. Regenerate pairing file
7. Reinstall SideStore using AltServer
Expand All @@ -49,11 +50,11 @@ Multiple possible causes.

If the above doesn't work, do the following:

1. Delete SideStore and all apps that you have installed from SideStore.
2. Reinstall SideStore.
3. Select pairing file and login. (It will give you a prompt to refresh SideStore, select no)
4. Install the `sidestore.ipa` file to your device.
5. Import the `sidestore.ipa` file into SideStore like how you would install any other IPA.
6. This will allow Sidestore to do a clean refresh, and hopefully fix the issue.
1. Delete SideStore and all apps that you have installed from SideStore
2. Reinstall SideStore
3. Import your pairing file and login. (It will give you a prompt to refresh SideStore, select no)
4. Install the `sidestore.ipa` file to your device
5. Import the `sidestore.ipa` file into SideStore like how you would install any other IPA
6. This will allow Sidestore to do a clean refresh, and hopefully fix the issue


15 changes: 8 additions & 7 deletions docs/troubleshooting/error-codes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ This means SideStore was not able to access the directory where app backups are

`SideStore.OperationError 1403`

Please make sure you are on the same Wi-Fi as your computer running SideJITServer and that your Firewall has been set appropriately.
Please make sure you are on the same Wi-Fi as your computer running SideJITServer and that your Firewall has been set appropriately. Alternatively, you can use the built in "Enable JIT" option to enable JIT on iOS 17.4-18.6 with StosVPN enabled and Wi-Fi or Airplane Mode.

#### (1412) Unable to connect to a V3 anisette server.

Expand All @@ -109,11 +109,17 @@ You do not appear to be connected to Wi-Fi and/or StosVPN. SideStore cannot refr

## Minimuxer Errors

#### (4) AFC was unable to manage files on the device.

`minimuxer.MinimuxerError 4`

This means you are attempting to enable JIT on an unsupported iOS version. SideStore only supports enabling JIT on iOS 17.4-18.6.

#### (27) AFC was unable to manage files on the device.

`minimuxer.MinimuxerError 27`

This means you have an invalid pairing file. Follow the steps to regenerate.
This means you have an invalid pairing file. Follow the steps in these docs to regenerate it.

More coming, open to contributions...

Expand Down Expand Up @@ -476,8 +482,3 @@ Updated information coming soon

This means that an error occurred while writing files to disk. Make sure your phone and PC both have plenty of available disk space and try again.

#### (1) AltJIT failed with error code 1 (iOS 17)

`AltServer.ProcessError`

If you are trying to enable JIT on an iOS 17 device, you may see this error. Make sure to install all dependencies and keep your device connected with the app open until JIT has successfully been enabled.
42 changes: 12 additions & 30 deletions docs/troubleshooting/troubleshooting.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Troubleshooting Guide
description: A guide to troubleshooting SideStore.
description: A guide to troubleshooting SideStore in situations without an error code.
---

## Installation
Expand All @@ -14,7 +14,7 @@ description: A guide to troubleshooting SideStore.
2. **Use Another Apple ID**: Try using another Apple ID. If needed, you can [create a new Apple ID](https://appleid.apple.com/account#!\&page=create) specifically for SideStore use for free.

#### Windows Instructions
1. **Trust Device**: After connecting your iOS device to your Windows computer, ensure you have said “Trust” on both your computer and iOS device. You can verify this by:
1. **Trust Device**: After connecting your iOS device to your Windows computer, ensure you have slected “Trust” on both your computer and iOS device. You can verify this by:
- Opening iTunes and checking if a dialog box appears asking if you want to trust the device.
2. **Run AltServer as Administrator**: Right-click on AltServer and select “Run as Administrator” to ensure proper permissions.
3. **Use Another Apple ID**: Try using another Apple ID. If needed, you can [create a new Apple ID](https://appleid.apple.com/account#!\&page=create) specifically for SideStore for free.
Expand Down Expand Up @@ -57,9 +57,9 @@ Another common issue during sign-in is not receiving a verification code when us

1. Visit [iCloud](https://www.icloud.com) on a web browser.
2. Click "Sign In."
3. When prompted, you will see two options: "Sign In" and "Use Different Apple Account."
3. You may be prompted with see two options: "Sign In" and "Use Different Apple Account."
- Select the bottom option, "Use Different Apple Account."
4. Enter your Apple ID and password.
4. Enter your Apple ID and password (don't use a passkey).
5. Apple will send you a verification code.
- Use this code in SideStore to complete the sign-in process.

Expand All @@ -68,42 +68,24 @@ Another common issue during sign-in is not receiving a verification code when us

### Resolving No Wi-Fi or VPN Error

1. Disable your cellular data / connect to a stable Wi-Fi network.
2. Ensure that Apple domains, and the domain for your anisette server, are not restricted. Check the following:
- Turn off any DNS blocking domains such as `oscp.apple.com`
1. Enable Airplane Mode and connect to a stable Wi-Fi network.
2. Ensure that Apple domains and the domain for your anisette server are not restricted. Check the following:
- Turn off any DNS servers blocking domains such as `oscp.apple.com`
- Disconnect from school/work Wi-Fi, try connecting to a restriction-free network.
3. Verify VPN is connected in StosVPN.
4. Turn StosVPN off, then back on, and wait a few seconds in SideStore before trying to refresh.
5. Create a brand new pairing file.
5. Regenerate your pairing file.
- If none of the above worked, it is very likely that the pairing file is corrupted. You can reference the documentation on how to create a new pairing file [here](/docs/installation/pairing-file).


## Cannot Choose Pairing File

### If you are unable to select a pairing file in Sidestore, follow these steps to resolve the issue:

1. **Check File Extension**: Make sure your pairing file's extension ends with `.mobiledevicepairing` or `.plist`. If it doesn't, double-check to see if you had zipped your pairing file before sending it to your phone. Failing to do so may lead to the file being corrupted during transport.
2. **Move Pairing File**: If you are unable to select the pairing file from within the app, rename the file to `ALTPairingFile.mobiledevicepairing` and try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad".
3. **Certificate Signing**: When signing SideStore with a certificate, you won't be able to select the pairing file from within the app. You can try the fix mentioned above. If you do not see the SideStore folder in the Files app, connect your phone to your computer, and you can drag and drop the pairing file to the files of the SideStore app. Ensure to change it to the name mentioned above.

## AltJIT

### AltServer says “JIT could not be enabled for [App]".

This could happen for a number of reasons. If you’re experiencing this issue, please check the following:

- Make sure AltServer has been updated to the latest version.
- Make sure the app you are trying to enable JIT for is running in the foreground on your device.
- Are you on public/work/school Wi-Fi? If so, your Wi-Fi might be preventing devices from discovering each other. Try connecting your computer to your phone’s hotspot and trying again. (If you're using an iPad, make sure it's connected to your hotspot as well.)
- Have you said “Trust” on both your Mac and iOS device after connecting your device to your Mac? You can check by Finder (macOS 10.15 Catalina or later) or iTunes (macOS 10.14 Mojave and earlier) and seeing if a dialog box pops up asking if you want to trust your phone.
- (Windows) Firewall might be blocking incoming network connections to AltServer. You must enable network access for AltServer in your firewall settings for it to receive refreshed apps from AltStore.
- (Windows) Did you install iTunes or iCloud from the Microsoft Store? If so, you’ll need to uninstall them and download the latest versions directly from Apple.
- You may need to make sure iTunes and iCloud are running on your computer as well.
- Finally, try plugging your iPhone or iPad into your computer. This should fix all connectivity problems, but does mean AltStore may not be able to automatically refresh apps for you in the background over Wi-Fi.

:::tip
If you can't find the answer to your question about AltJIT here, you can email [[email protected]](mailto:[email protected]), and they will try to get back to you as soon as they can.
:::
1. **Reimport Pairing File**: Use idevice pair to regenerate and import your pairing file to your device. If idevice pair doesn't work, try jitterbugpair and follow the steps below.
2. **Check File Extension**: Make sure your pairing file's extension ends with `.mobiledevicepairing` or `.plist`. If it doesn't, double-check to see if you had zipped your pairing file before sending it to your phone. Failing to do so may lead to the file being corrupted during transport.
3. **Move Pairing File**: If you are unable to select the pairing file from within the app, rename the file to `ALTPairingFile.mobiledevicepairing` and try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad".
4. **Certificate Signing**: When signing SideStore with a certificate, you won't be able to select the pairing file from within the app. You can try the fix mentioned above. If you do not see the SideStore folder in the Files app, connect your phone to your computer, and you can drag and drop the pairing file to the files of the SideStore app. Make sure to change it to the name mentioned above.

## AltServer

Expand Down