Skip to content

Commit 599351f

Browse files
Updates (#149)
* Update windows.mdx Signed-off-by: CelloSerenity <[email protected]> * Update anisette.mdx Signed-off-by: CelloSerenity <[email protected]> * Update docusaurus.config.js Signed-off-by: CelloSerenity <[email protected]> * Update TRANSLATION_GUIDE.md Signed-off-by: CelloSerenity <[email protected]> * Update common-issues.mdx Signed-off-by: CelloSerenity <[email protected]> * Update error-codes.mdx Signed-off-by: CelloSerenity <[email protected]> * Update error-codes.mdx Signed-off-by: CelloSerenity <[email protected]> * Update linux.mdx Signed-off-by: CelloSerenity <[email protected]> * Update pairing-file.mdx Signed-off-by: CelloSerenity <[email protected]> * Update linux.mdx Signed-off-by: CelloSerenity <[email protected]> * Update linux.mdx Signed-off-by: CelloSerenity <[email protected]> * Update error-codes.mdx Signed-off-by: CelloSerenity <[email protected]> * Update post-install.mdx Signed-off-by: CelloSerenity <[email protected]> * Update faq.mdx Signed-off-by: CelloSerenity <[email protected]> * Update release-notes.mdx Signed-off-by: CelloSerenity <[email protected]> * Update jit.mdx Signed-off-by: CelloSerenity <[email protected]> * Update faq.mdx Signed-off-by: CelloSerenity <[email protected]> * Update faq.mdx Signed-off-by: CelloSerenity <[email protected]> * Update intro.mdx * Update prerequisites.mdx * Update prerequisites.mdx Signed-off-by: CelloSerenity <[email protected]> * Update intro.mdx Signed-off-by: CelloSerenity <[email protected]> * Update common-issues.mdx Signed-off-by: CelloSerenity <[email protected]> * Update troubleshooting.mdx Signed-off-by: CelloSerenity <[email protected]> * Update common-issues.mdx Signed-off-by: CelloSerenity <[email protected]> * Update error-codes.mdx Signed-off-by: CelloSerenity <[email protected]> * Update jit.mdx Signed-off-by: CelloSerenity <[email protected]> --------- Signed-off-by: CelloSerenity <[email protected]>
1 parent c357962 commit 599351f

File tree

4 files changed

+45
-63
lines changed

4 files changed

+45
-63
lines changed

docs/advanced/jit.mdx

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,41 +4,39 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps
44
---
55

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

99
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).
1010

1111
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".
1212
:::
1313

1414
## Prerequisites
15-
* 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.
16-
* At least 1 free app slot (if sideloading).
15+
* 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.
1716

18-
## StikDebug installation with Apple App Store (Doesn't require an app slot)
17+
## StikDebug installation with Apple App Store
1918

2019
1. **Install StikDebug**
21-
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.
20+
Install StikDebug from the [Apple App Store](https://apps.apple.com/us/app/stikdebug/id6744045754).
21+
:::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.
22+
:::
2223

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

2627

2728
### Standard installation procedures:
2829

29-
1. **Enable VPN:**
30-
Start by activating StosVPN (if sideloading StikDebug) or the built-in VPN in the official StikDebug.
30+
1. **Upload the Pairing File:**
31+
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).
3132

32-
2. **Upload the Pairing File:**
33-
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).
33+
2. **Mount the DDI:**
34+
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.
3435

3536
## To enable JIT:
3637

3738
1. **Enable VPN:**
38-
Start by activating the built-in VPN in StikDebug.
39+
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.
3940

4041
2. **Activate JIT:**
41-
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.
42-
43-
### Offline JIT Enabling
44-
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.
42+
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.

docs/troubleshooting/common-issues.mdx

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,26 +16,27 @@ This page is currently a work in progress. The information provided should be ac
1616
Connection issues or an invalid pairing file.
1717
#### Resolution
1818
1. Attempt to reconnect
19-
2. Generate and import a new pairing file using idevice pair. See our [Pairing File instructions](/docs/installation/pairing-file) for details.
19+
2. Generate and import a new pairing file using idevice pair. See our [Pairing File instructions](/docs/installation/pairing-file) for details
2020

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

31-
### SideStore Hangs Halfway Through Installation
32+
### SideStore Hangs Partway Through Installation
3233
#### Cause
33-
Cache issues.
34+
Cache or protocol issues.
3435
#### Resolution
35-
1. Restart SideStore
36+
1. Update SideStore, if applicable. Otherwise, just restart
3637
2. Clear Cache
3738
3. Change Anisette Server
38-
4. In servers- reset adi.pb, then sign out of SideStore and sign back in.
39+
4. In servers- reset adi.pb, then sign out of SideStore and sign back in
3940
5. Restart device
4041
6. Regenerate pairing file
4142
7. Reinstall SideStore using AltServer
@@ -49,11 +50,11 @@ Multiple possible causes.
4950

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

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

5960

docs/troubleshooting/error-codes.mdx

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ This means SideStore was not able to access the directory where app backups are
9393

9494
`SideStore.OperationError 1403`
9595

96-
Please make sure you are on the same Wi-Fi as your computer running SideJITServer and that your Firewall has been set appropriately.
96+
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.
9797

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

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

110110
## Minimuxer Errors
111111

112+
#### (4) AFC was unable to manage files on the device.
113+
114+
`minimuxer.MinimuxerError 4`
115+
116+
This means you are attempting to enable JIT on an unsupported iOS version. SideStore only supports enabling JIT on iOS 17.4-18.6.
117+
112118
#### (27) AFC was unable to manage files on the device.
113119

114120
`minimuxer.MinimuxerError 27`
115121

116-
This means you have an invalid pairing file. Follow the steps to regenerate.
122+
This means you have an invalid pairing file. Follow the steps in these docs to regenerate it.
117123

118124
More coming, open to contributions...
119125

@@ -476,8 +482,3 @@ Updated information coming soon
476482

477483
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.
478484

479-
#### (1) AltJIT failed with error code 1 (iOS 17)
480-
481-
`AltServer.ProcessError`
482-
483-
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.

docs/troubleshooting/troubleshooting.mdx

Lines changed: 12 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Troubleshooting Guide
3-
description: A guide to troubleshooting SideStore.
3+
description: A guide to troubleshooting SideStore in situations without an error code.
44
---
55

66
## Installation
@@ -14,7 +14,7 @@ description: A guide to troubleshooting SideStore.
1414
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.
1515

1616
#### Windows Instructions
17-
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:
17+
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:
1818
- Opening iTunes and checking if a dialog box appears asking if you want to trust the device.
1919
2. **Run AltServer as Administrator**: Right-click on AltServer and select “Run as Administrator” to ensure proper permissions.
2020
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.
@@ -57,9 +57,9 @@ Another common issue during sign-in is not receiving a verification code when us
5757

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

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

6969
### Resolving No Wi-Fi or VPN Error
7070

71-
1. Disable your cellular data / connect to a stable Wi-Fi network.
72-
2. Ensure that Apple domains, and the domain for your anisette server, are not restricted. Check the following:
73-
- Turn off any DNS blocking domains such as `oscp.apple.com`
71+
1. Enable Airplane Mode and connect to a stable Wi-Fi network.
72+
2. Ensure that Apple domains and the domain for your anisette server are not restricted. Check the following:
73+
- Turn off any DNS servers blocking domains such as `oscp.apple.com`
7474
- Disconnect from school/work Wi-Fi, try connecting to a restriction-free network.
7575
3. Verify VPN is connected in StosVPN.
7676
4. Turn StosVPN off, then back on, and wait a few seconds in SideStore before trying to refresh.
77-
5. Create a brand new pairing file.
77+
5. Regenerate your pairing file.
7878
- 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).
7979

8080

8181
## Cannot Choose Pairing File
8282

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

85-
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.
86-
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".
87-
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.
88-
89-
## AltJIT
90-
91-
### AltServer says “JIT could not be enabled for [App]".
92-
93-
This could happen for a number of reasons. If you’re experiencing this issue, please check the following:
94-
95-
- Make sure AltServer has been updated to the latest version.
96-
- Make sure the app you are trying to enable JIT for is running in the foreground on your device.
97-
- 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.)
98-
- 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.
99-
- (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.
100-
- (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.
101-
- You may need to make sure iTunes and iCloud are running on your computer as well.
102-
- 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.
103-
104-
:::tip
105-
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.
106-
:::
85+
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.
86+
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.
87+
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".
88+
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.
10789

10890
## AltServer
10991

0 commit comments

Comments
 (0)