Skip to content

Commit

Permalink
[Add] cannot select pairing file to troubleshooting guide (#61)
Browse files Browse the repository at this point in the history
* Update sparserestore.mdx

Signed-off-by: neoarz <[email protected]>

* Update faq.mdx

Signed-off-by: neoarz <[email protected]>

* Update faq.mdx

Signed-off-by: neoarz <[email protected]>

* Update prerequisites.mdx

Signed-off-by: neoarz <[email protected]>

* ADD}-Cannot-Select-Pairing-File-to-Troubleshooting-Guide

---------

Signed-off-by: neoarz <[email protected]>
  • Loading branch information
neoarz authored Jan 4, 2025
1 parent 0b73638 commit 50b2c14
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 3 deletions.
4 changes: 2 additions & 2 deletions docs/advanced/sparserestore.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,14 @@ description: A tutorial on how to install more than 3 apps via SideStore using t

:::note

The SparseRestore "Bypass 3 app limit" exploit **only fully works on iOS/iPadOS versions between 17.0 and 18.1 beta 4 (not including 17.7.1)**. If you are not on these versions and it doesn't work, **please do not ask for support on this**.
The SparseRestore "Bypass 3 app limit" exploit **only works on iOS/iPadOS versions between 17.0 and 18.1 beta 4 (not including 17.7.1)**. If you are not on these versions and it doesn't work, **please do not ask for support on this**.

:::

## Prerequisites
* An iDevice running versions supported by the SparseRestore exploit (see note above).
* At least 1 free app slot.
* SideStore version 0.5.9 or later.
* SideStore version 0.5.9 or later. You can find the latest versions [here](https://github.com/SideStore/SideStore/releases).
* To perform this exploit, you MUST have **Find My** turned off on your iDevice during the process. It will not work otherwise. Here is how you can turn it off:
- Open the Settings app.
- Tap on your name at the top.
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/mac.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ sidebar_position: 4
Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites), and that you have a [pairing file](pairing-file)!

1. Download and run AltServer from [AltStore's website](https://AltStore.io).
2. Download the SideStore IPA from [our website](https://sidestore.io).
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
3. Hold option/alt and click on the AltServer menu bar icon. Click "Sideload .ipa", and select the SideStore IPA file.
4. Approve the "Developer App" with your Apple ID's email.
* You can find this in Settings, under "General", and then "VPN & Device Management".
Expand Down
6 changes: 6 additions & 0 deletions docs/troubleshooting/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,13 @@ Another common issue during sign-in is not receiving a verification code when us
- After creating a new pairing file, go to Sidestore settings and press "Reset pairing file", then choose the new pairing file you just created.


## 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".
2. **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.


## AltServer
Expand Down

0 comments on commit 50b2c14

Please sign in to comment.