diff --git a/docs/advanced/pairing-file.mdx b/docs/advanced/pairing-file.mdx index 91024e9b..c4b3327d 100644 --- a/docs/advanced/pairing-file.mdx +++ b/docs/advanced/pairing-file.mdx @@ -3,11 +3,11 @@ title: Pairing File description: A guide on manually reimporting your pairing file. --- :::warning -Caution, if you update or reset your iDevice, your pairing file will expire and you will need to reimport it. This also occurs at random times. This is simply because of how Apple's software works, and there is nothing we can do at this point to fix it. This guide instructs you how to manually reimport your pairing file into SideStore with iloader. +Caution, if you update or reset your iDevice, your pairing file will expire and you will need to reimport it. This also occurs at random times. This is simply because of how Apple's software works, and there is nothing we can do at this point to fix it. This guide instructs you how to manually replace your pairing file with iloader. ::: -## Reimporting your pairing file +## Replacing your pairing file 1. Make sure you have followed the steps in the [install guide](../installation/prerequisites) to install and setup iloader and SideStore. 2. For best results, connect your iDevice to your computer via USB cable, but if your device appears wirelessly that works too. 3. Click "Manage Pairing File" -4. To the right of "SideStore" and any other apps you wish, click "Place Pairing File". "Pairing file placed successfully!" should appear in green. +4. To the right of "SideStore" and any other apps you wish, click "Place". "Pairing file placed successfully!" should appear in green. diff --git a/docs/faq.mdx b/docs/faq.mdx index 41e88cea..a3802740 100644 --- a/docs/faq.mdx +++ b/docs/faq.mdx @@ -46,10 +46,6 @@ It does not, as it's only connecting to your own device. No remote servers are u It does not, as there is no remote server used. -### Updating SideStore hangs towards the end - -Go to the homescreen for it to finish. We don't know why this happens, but it might have to do with using a VPN to direct `installd` to refresh SideStore (itself). - ### Can I sign more than 3 apps to be active? Normally, no, as that’s an iOS and developer account limitation. Apple only allows 3 apps to be installed using a free Apple Developer account. @@ -62,7 +58,7 @@ A tutorial for using this can be found [here](advanced/sparserestore). ### I have a problem or bug or request for a feature or quality of life improvement -Please make a GitHub issue on our GitHub page to make a bug report or feature request (with appropriate labels)! +Please check [common issues](troubleshooting/common-issues) and existing GitHub issues, if you don't find it, please create a new a GitHub issue on our GitHub page to make a bug report or feature request (with appropriate labels)! ### I am a developer, how does this affect me? @@ -116,22 +112,10 @@ Yep! Just click the update button when it appears! ### I want to test a SideStore version, and I want my data to stay when switching to a test version. Do I remove my app or sideload the test version via SideStore? -You can sideload a nightly SideStore version via SideStore or AltServer and your data should be the same, or enable beta updates and select "nightly" in Settings. We cannot guarantee your data transfers when testing an unofficial or nightly build. - -### My apps disappeared from SideStore and I don't know what to do! - -Don't panic! Re-sideload the apps as usual without removing them from your device, and your data should be fine. Unfortunately it's possible that your deactivated apps are gone, but to confirm that, just refresh SideStore to see if they come back. - -### Cannot start DebugServer - -There is times when the DebugServer doesn't work. However, there is a fix you can try: - -**Make a new pairing file** - -[Reimport your pairing file using iloader.](advanced/pairing-file) +You can sideload a nightly SideStore version via SideStore or iloader and your data should remain, or enable beta updates and select "nightly" in Settings. We cannot guarantee your data transfers when testing an unofficial or nightly build. ### Currently Known issues -If you're currently having issues and want to know if we already know about them. Then check out our GitHub issue page which has a list of known issues and ways to mitigate some of the issues you might be having. Some of the issues in this list might be known that are not there, but are in the GitHub issues section. https://github.com/SideStore/SideStore/issues/490 +If you're currently having issues and want to know if we already know about them, check out our GitHub issue page and the troubleshooting page which has a list of known issues and ways to mitigate some of the issues you might be having. Some of the issues in this list might be known that are not there, but are in the GitHub issues section. [GitHub](https://github.com/SideStore/SideStore/issues/490), [troubleshooting](/troubleshooting/troubleshooting). If you have any issues that aren't in this list. Just make a GitHub issue or [join our discord.](https://dis.sidestore.io/) diff --git a/docs/intro.mdx b/docs/intro.mdx index b1f0298b..0e188432 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -8,4 +8,4 @@ Welcome to SideStore! SideStore makes sideloading applications on iOS/iPadOS 14+ devices easy. -To get started, go to the [Prerequisites](/docs/installation/prerequisites.mdx) page and follow the instructions. +To get started, go to the [Prerequisites](installation/prerequisites.mdx) page and follow the instructions. diff --git a/docs/troubleshooting/common-issues.mdx b/docs/troubleshooting/common-issues.mdx index 39ac0671..6de71f8d 100644 --- a/docs/troubleshooting/common-issues.mdx +++ b/docs/troubleshooting/common-issues.mdx @@ -1,6 +1,6 @@ --- title: Common Issues -description: Common issues found in SideStore not associated with error codes. +description: Common issues encountered using SideStore. --- :::warning @@ -11,27 +11,29 @@ This page is currently a work in progress. The information provided should be ac ## Common Issues with SideStore -### I am receiving error code: "X" +### I have an issue with the latest nightly +#### Cause +Our nightly builds include bleeding-edge features and improvements, some of which may cause instablity. #### Resolution -Check our helpful [list of error codes](error-codes)! +Switch to the latest stable build. Please do not create issues or request support for bugs encountered in nightly builds. -### AFC Connection Failure +### I am receiving error code: "X" #### Cause -Connection issues or an invalid pairing file. +An error occurred. #### Resolution -1. Attempt to reconnect. Ensure Wi-Fi and StosVPN are connected. -2. Load and import a new pairing file using iloader. +Check our helpful [list of error codes](error-codes)! -### No Wi-Fi or VPN Connection +### AFC Connection Failure / 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-blockers -3. Try again (spamming the button sometimes helps) -4. Restart SideStore -5. Restart StosVPN -6. Load and import a new pairing file using iloader. +3. Ensure StosVPN and Wi-Fi are both connected +4. Try again (spamming the button sometimes helps) +5. Restart SideStore +6. Restart StosVPN +7. [Replace your pairing file](../advanced/pairing-file) using iloader. ### SideStore Hangs Partway Through Installation #### Cause @@ -57,8 +59,10 @@ 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. 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 +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 - +### I couldn't find my issue here +#### Resolution +Please check our [troubleshooting list](troubleshooting). diff --git a/docs/troubleshooting/error-codes.mdx b/docs/troubleshooting/error-codes.mdx index 832b0217..31bc641e 100644 --- a/docs/troubleshooting/error-codes.mdx +++ b/docs/troubleshooting/error-codes.mdx @@ -51,7 +51,7 @@ This means that SideStore could not locate the file to download or install, most `SideStore.OperationError 1006` -This means that your pairing file has been corrupted. [Reimport it with iloader](../advanced/pairing-file). +This means that your pairing file has been corrupted. [Replace it using iloader](../advanced/pairing-file). #### (1007) This app is in an invalid format. @@ -105,7 +105,7 @@ Your device was unable to receive data from a V3 anisette server. Please try aga `SideStore.OperationError 1414` -You do not appear to be connected to Wi-Fi and/or StosVPN. SideStore cannot refresh or install applications without Wi-Fi and StosVPN, ensure both are connected. If that doesn't work, [reimport your pairing file with iloader](../advanced/pairing-file). +You do not appear to be connected to Wi-Fi and/or StosVPN. SideStore cannot refresh or install applications without Wi-Fi and StosVPN, ensure both are connected. If that doesn't work, [replace your pairing file using iloader](../advanced/pairing-file). ## Minimuxer Errors @@ -120,7 +120,7 @@ This means you are attempting to enable JIT on an unsupported iOS version. SideS `minimuxer.MinimuxerError 27` -Ensure Wi-Fi and StosVPN are both connected. If the error doesn't resolve, [reimport your pairing file with iloader](../advanced/pairing-file). +Ensure Wi-Fi and StosVPN are both connected. If the error doesn't resolve, [replace your pairing file with iloader](../advanced/pairing-file). ## Apple Developer Errors diff --git a/docs/troubleshooting/troubleshooting.mdx b/docs/troubleshooting/troubleshooting.mdx index 2c3582d5..c8dd2d6b 100644 --- a/docs/troubleshooting/troubleshooting.mdx +++ b/docs/troubleshooting/troubleshooting.mdx @@ -18,6 +18,9 @@ description: A guide to troubleshooting SideStore in situations without an error - Opening iTunes and checking if a dialog box appears asking if you want to trust the device. 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 for free. +### Updating SideStore hangs towards the end + +Go to the homescreen for it to finish. We don't know why this happens, but it might have to do with using a VPN to direct `installd` to refresh SideStore (itself). ## Sign-In Issues @@ -58,14 +61,10 @@ Another common issue during sign-in is not receiving a verification code when us - Use this code in SideStore to complete the sign-in process. -## Can't Refresh or Install Apps +## My apps disappeared from SideStore and I don't know what to do! + +Don't panic! Re-sideload the apps as usual without removing them from your device, and your data should be fine. Unfortunately it's possible that your deactivated apps are gone, but to confirm that, just refresh SideStore to see if they come back. -### Resolving No Wi-Fi or VPN Error +## Cannot start DebugServer -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 `ocsp.apple.com` - - Disconnect from school/work Wi-Fi and connect 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. [Reimport your pairing file using iloader](../advanced/pairing-file). +There are times when the DebugServer doesn't work. However, you can try [replacing your pairing file using iloader](advanced/pairing-file).