Skip to content

Commit

Permalink
Small adjustments to 3 app limit bypass and prerequisites (#59)
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]>

* Small-Adjustments-to-3-App-Limit-Bypass-and-Prerequisites

* h

---------

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

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

:::
:::note

To perform this exploit, you MUST have **Find My** turned off on your iDevice during the process. It will not work otherwise.

:::

## 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
* 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.
* 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.
- Tap on Find My.
- Tap on Find My iPhone/iPad.
- Turn off Find My iPhone/iPad.
- You may be required to enter your Apple ID password to confirm.

> **Note:** You may still not be able to turn off Find My since having Stolen Device Protection on might prevent you from turning it off. Turn off Stolen Device Protection before trying to turn off Find My.
## Steps
1. Install SparseBox. This can be done with a variety of methods, but for the purposes of this, install it with SideStore. The latest version can be found [here](https://nightly.link/khanhduytran0/SparseBox/workflows/build/main/artifact.zip) (unzip artifact.zip for the .ipa file)
2. Tick on "Disable App Limit" in Sidestore, and make SideStore is **closed** (not in background) , then open SparseBox.
3. Set up Wireguard , select your paring file and tap 'Bypass 3-app limit'. This should bring up a log output. Wait for it to say `idevicebackup2 exited with code -18` or `idevicebackup2 exited with code 2`, then close the app. No need to hit apply.
4. Re-open SideStore, and scroll down in Sidestore setings. Press "clear cache", this will allow the exploit to be seen by Sidestore.
5. Test that the exploit has worked (you may need to install more than one app to test, depending on how many free slots you have). If it throws an error about the limit, reopen SideStore or retry the exploit. If it installs the app, congratulations! You can now have more than 3 apps installed at one time.
1. Install SparseBox. This can be done with a variety of methods, but for the purposes of this, install it with SideStore. The latest version can be found [here](https://nightly.link/khanhduytran0/SparseBox/workflows/build/main/artifact.zip) (unzip artifact.zip for the .ipa file).

5.5. If you want/need Find My for other purposes, you can now turn it back on.
2. Tick on "Disable App Limit" in SideStore, and make sure SideStore is **closed** (not in background), then open SparseBox.

3. Set up WireGuard, select your pairing file and tap 'Bypass 3-app limit'. This should bring up a log output. Wait for it to say `idevicebackup2 exited with code -18` or `idevicebackup2 exited with code 2`, then close the app. No need to hit apply.

4. Re-open SideStore, and scroll down in SideStore settings. Press "clear cache", this will allow the exploit to be seen by SideStore.

5. Test that the exploit has worked (you may need to install more than one app to test, depending on how many free slots you have). If it throws an error about the limit, reopen SideStore or retry the exploit. If it installs the app, congratulations! You can now have more than 3 apps installed at one time.

## Notes
Due to certain limitations, this exploit must be done for every 3 additional apps you sideload.

If you want/need Find My for other purposes, you can now turn it back on. However, if you want to install or refresh more apps, you will need to turn it on again.

## Alternatives
If either the exploit doesn't work for you, or your iDevice is on an unsupported version, there is an alternative to be able to use more than 3 apps at once. LiveContainer, developed by Duy Tran Khanh ([khanhduytran0](https://github.com/khanhduytran0)) (the person who also made SparseBox), allows for iOS apps to be run in containers in-app rather than installing them separately. This may also be easier to use over SparseRestore in some cases. The GitHub page can be found [here](https://github.com/khanhduytran0/LiveContainer).
12 changes: 6 additions & 6 deletions docs/getting-started/prerequisites.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,24 +11,24 @@ SideStore's installation process can seem tricky, but with the ***one-time*** us
To install SideStore, you will need:
- An iOS or iPadOS device running iOS or iPadOS 14 or higher.
- A Windows, macOS, or Linux computer (Linux support is experimental).
- An Apple ID
- An Apple ID.
- The WireGuard iOS/iPadOS app.
- And some time (This is a quick process, but you should leave time for troubleshooting).
- Some time (This is a quick process, but you should leave time for troubleshooting).

Users of iOS/iPadOS 16 or higher *must* have Developer Mode enabled. Do this by:
1. Open the Settings app.
2. Go to the 'Privacy and Security Section'
2. Go to the 'Privacy and Security' section.
3. Turn on 'Developer Mode' at the bottom.

> **Note:** You will only see the 'Developer Mode' option after you have successfully installed SideStore.
## WireGuard

SideStore utilizes an on-device WireGuard VPN which allows SideStore to communicate to internal services.
SideStore utilizes an on-device WireGuard VPN which allows SideStore to communicate with internal services.

1. Download the WireGuard app from the [Official App Store](https://apps.apple.com/us/app/wireguard/id1441195209).
2. Also, download the WireGuard config found [here.](https://github.com/SideStore/SideStore/releases/download/0.3.1/SideStore.conf)
3. Open WireGuard, and press the 'Add a Tunnel' or '+' buttons.
2. Also, download the WireGuard config found [here](https://github.com/SideStore/SideStore/releases/download/0.3.1/SideStore.conf).
3. Open WireGuard, and press the 'Add a Tunnel' or '+' button.
4. Select 'Create from file or archive', and choose the SideStore.conf file.
5. Your device may ask if you want to 'Allow VPN Configurations', choose 'Allow' and authenticate.
6. Toggle on the SideStore VPN option.
Expand Down

0 comments on commit 706b228

Please sign in to comment.