From 0f35377956271b99316bbd00641bbab33fdf0b7a Mon Sep 17 00:00:00 2001
From: Fakey McFakename <195480169+CelloSerenity@users.noreply.github.com>
Date: Thu, 22 May 2025 13:49:00 -0600
Subject: [PATCH 01/78] Update mac.mdx
---
docs/installation/mac.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index 06ee56c6..343c6edf 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -13,4 +13,4 @@ Before you start, make sure to have all steps completed found in the [Prerequisi
* You can find this in Settings, under "General", and then "VPN & Device Management".
5. Open SideStore, select your pairing file, and sign in with your Apple ID.
-When you finish, follow the [post-install instructions](installation/post-install).
+When you finish, follow the [post-install instructions](post-install).
From f1b166a675df5df275a5e56372c319eb79abfe8f Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 13:19:47 -0600
Subject: [PATCH 02/78] Update jit.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/advanced/jit.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx
index 5e2bbb7f..48e0ca0d 100644
--- a/docs/advanced/jit.mdx
+++ b/docs/advanced/jit.mdx
@@ -22,8 +22,8 @@ There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more.
## StikDebug installation with SideStore
-1. **Obtain StiDebug:**
- Add the StikJIT AltSource to SideStore [here](sidestore://source?url=https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json) (You must have SideStore installed or this link will not function).
+1. **Obtain StikDebug:**
+ Add the StikDebug (StikJIT) AltSource to SideStore [here](sidestore://source?url=https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json) (You must have SideStore installed or this link will not function).
2. **Install:**
Use SideStore to install StikDebug.
From f0e109b921cdc7a0c146c4598b1fe8bdaef82754 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 13:20:19 -0600
Subject: [PATCH 03/78] Update app-sources.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/advanced/app-sources.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/app-sources.mdx b/docs/advanced/app-sources.mdx
index 9dc5527a..956bc31b 100644
--- a/docs/advanced/app-sources.mdx
+++ b/docs/advanced/app-sources.mdx
@@ -21,4 +21,4 @@ For more info, see [URL Schema](/docs/advanced/url-schema). It is often helpful
## That's it!
-Here are some good existing AltSources you can copy-and-paste into SideStore: The [SideStore Community Source](https://github.com/SideStore/Community-Source), the [official AltStore Source](https://apps.altstore.io), the [StikDebug Source](https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json) source, the [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json), and the [DolphiniOS Source](https://altstore.oatmealdome.me).
+Here are some good existing AltSources you can copy-and-paste into SideStore: The [SideStore Community Source](https://github.com/SideStore/Community-Source), the [official AltStore Source](https://apps.altstore.io), the [StikDebug Source](https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json), the [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json), and the [DolphiniOS Source](https://altstore.oatmealdome.me).
From 046895a30ddada649131f5cf5f0dea3d38996ba8 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 13:22:08 -0600
Subject: [PATCH 04/78] Update app-sources.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/advanced/app-sources.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/app-sources.mdx b/docs/advanced/app-sources.mdx
index 956bc31b..e4010bf5 100644
--- a/docs/advanced/app-sources.mdx
+++ b/docs/advanced/app-sources.mdx
@@ -17,7 +17,7 @@ You can create a link to automatically add your AltSource by using this template
```
sidestore://source?url=[source url]
```
-For more info, see [URL Schema](/docs/advanced/url-schema). It is often helpful to create the link to your AltSource in this format, then put it into a link shortener such as ```tinyurl.com```. However, if a user tries to use a sidestore:// link without SideStore already installed, it will crash, so some documentation may be helpful.
+For more info, see [URL Schema](/docs/advanced/url-schema). It is often helpful to create the link to your AltSource in this format, then put it into a link shortener such as `tinyurl.com`. However, if a user tries to use a `sidestore://` link without SideStore already installed, it will crash, so some documentation may be helpful.
## That's it!
From e7a874861c21bb4c4daf4266e8f0d1b514784087 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 14:40:16 -0600
Subject: [PATCH 05/78] Update mac.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/mac.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index 343c6edf..6e1c1e55 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -6,7 +6,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 AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your /Applications folder, then run it. It should appear as an icon in your menu bar.
+1. Download AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your `Applications` folder, then run it. It should appear as an icon in your menu bar.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
3. Hold option 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 on your secondary device.
From 1ba6757f34cf164819ef17291f0ced25846e8a42 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 14:45:26 -0600
Subject: [PATCH 06/78] Update prerequisites.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/prerequisites.mdx | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx
index e0912a53..cd6a292a 100644
--- a/docs/installation/prerequisites.mdx
+++ b/docs/installation/prerequisites.mdx
@@ -9,11 +9,12 @@ SideStore's installation process may seem tricky, but with the ***one-time*** us
## Requirements
To install SideStore, you will need:
-- An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher.
-- A Windows, macOS, or Linux computer (Linux support is experimental).
-- An Apple ID.
-- The StosVPN app.
-- Some time (This is a quick process, but you should leave time for troubleshooting).
+- An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher
+- A Windows, macOS, or Linux computer (Linux support is experimental)
+- An Apple ID
+- The StosVPN app
+- A Wi-Fi connection
+- 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.
From afc514fa47e193e3ef08fae6269bea506f6deed2 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 15:34:05 -0600
Subject: [PATCH 07/78] Update app-sources.mdx
---
docs/advanced/app-sources.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/app-sources.mdx b/docs/advanced/app-sources.mdx
index e4010bf5..85a03633 100644
--- a/docs/advanced/app-sources.mdx
+++ b/docs/advanced/app-sources.mdx
@@ -21,4 +21,4 @@ For more info, see [URL Schema](/docs/advanced/url-schema). It is often helpful
## That's it!
-Here are some good existing AltSources you can copy-and-paste into SideStore: The [SideStore Community Source](https://github.com/SideStore/Community-Source), the [official AltStore Source](https://apps.altstore.io), the [StikDebug Source](https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json), the [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json), and the [DolphiniOS Source](https://altstore.oatmealdome.me).
+Here are some good existing AltSources you can copy-and-paste into SideStore: The [SideStore Community Source](https://github.com/SideStore/Community-Source), the [official AltStore Source](https://apps.altstore.io), the [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json), and the [DolphiniOS Source](https://altstore.oatmealdome.me).
From 310119d4b191bced23632dbdc1d6c91f29128b30 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 15:35:25 -0600
Subject: [PATCH 08/78] Update jit.mdx
---
docs/advanced/jit.mdx | 11 -----------
1 file changed, 11 deletions(-)
diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx
index 48e0ca0d..59a929fc 100644
--- a/docs/advanced/jit.mdx
+++ b/docs/advanced/jit.mdx
@@ -20,17 +20,6 @@ There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more.
2. **Installation procedures:**
Follow the standard installation procedures in the usage guide below.
-## StikDebug installation with SideStore
-
-1. **Obtain StikDebug:**
- Add the StikDebug (StikJIT) AltSource to SideStore [here](sidestore://source?url=https://raw.githubusercontent.com/StephenDev0/StikDebug/refs/heads/main/repo.json) (You must have SideStore installed or this link will not function).
-
-2. **Install:**
- Use SideStore to install StikDebug.
-
-3. **Installation procedures:**
- Follow the standard installation procedures in the usage guide below.
-
### Standard installation procedures:
From 1136252639f26bb679f26e4730371bf39ec37c19 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 15:38:47 -0600
Subject: [PATCH 09/78] Update jit.mdx
---
docs/advanced/jit.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx
index 59a929fc..5f856074 100644
--- a/docs/advanced/jit.mdx
+++ b/docs/advanced/jit.mdx
@@ -32,10 +32,10 @@ There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more.
## To enable JIT:
1. **Enable VPN:**
- Start by activating StosVPN (if sideloading) or the built-in VPN in StikDebug.
+ Start by activating the built-in VPN in StikDebug.
2. **Activate JIT:**
- Select the “Enable JIT” button and select an app from the list to attach a debugger/activate JIT functionality.
+ Select the “Enable JIT” button and select an app from the list (must be sideloaded with the proper entitlements) 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.
From 1db28efcd6b888631ea43d07d21688e59ce8be35 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 15:39:19 -0600
Subject: [PATCH 10/78] Update jit.mdx
---
docs/advanced/jit.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx
index 5f856074..d03728f4 100644
--- a/docs/advanced/jit.mdx
+++ b/docs/advanced/jit.mdx
@@ -35,7 +35,7 @@ There are many methods to enabling JIT, such as AltJIT, SideJITServer, and more.
Start by activating the built-in VPN in StikDebug.
2. **Activate JIT:**
- Select the “Enable JIT” button and select an app from the list (must be sideloaded with the proper entitlements) to attach a debugger/activate JIT functionality.
+ 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.
From e3a48be74ce61e78fc9687ac22d3f234bd4e56dd Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 15:43:55 -0600
Subject: [PATCH 11/78] Update mac.mdx
---
docs/installation/mac.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index 6e1c1e55..3515baad 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -6,7 +6,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 AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your `Applications` folder, then run it. It should appear as an icon in your menu bar.
+1. Download AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your `Applications` folder, then open it (using Finder, Launchpad, or Spotlight). It should appear as an icon in your menu bar.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
3. Hold option 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 on your secondary device.
From e03c89ae9f311f6b6eb5c0b1a7247db14cc03e23 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 16:15:14 -0600
Subject: [PATCH 12/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 5dda3158..5bf1c1e1 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -6,7 +6,7 @@ sidebar_position: 2
iDevicePair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
-Download iDevicePair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe), [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg), or Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [aarch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
+Download iDevicePair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe), [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg), or Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
## Pairing Instructions
From ab70b80482c505db0c561afd4b6a66b412b5d83c Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 16:16:36 -0600
Subject: [PATCH 13/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 5bf1c1e1..64bf3887 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -30,7 +30,7 @@ Download iDevicePair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_
### Linux
:::note
-The iDevicePair instructions for Linux are a work-in-progress. For now, instructions to create a pairing file using JitterbugPair for Linux are below!
+The iDevicePair instructions for Linux are a work-in-progress, but iDevicePair is pretty intuitive, so you can give it a try if you want. For now, instructions to create a pairing file using JitterbugPair for Linux are below!
:::
These instructions expect that you are familiar with the linux commandline.
From 9c8368e642c568a4e6549597508416bce775ed8a Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 17:48:58 -0600
Subject: [PATCH 14/78] Update jit.mdx
---
docs/advanced/jit.mdx | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx
index d03728f4..9087cd0c 100644
--- a/docs/advanced/jit.mdx
+++ b/docs/advanced/jit.mdx
@@ -5,7 +5,9 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps
:::note
-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. As an alternative, SideStore 0.6.2-nightly.2025.04.15 also includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN and Wi-Fi or with mobile data and Wi-Fi disabled.
+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-nightly.2025.04.15 also includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN and Wi-Fi or with mobile data and Wi-Fi disabled.
:::
## Prerequisites
From 7d1a4d3a24bac38e530dcbff2ad5fb5cd7e99ed2 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 17:50:19 -0600
Subject: [PATCH 15/78] Update jit.mdx
---
docs/advanced/jit.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx
index 9087cd0c..a0af967e 100644
--- a/docs/advanced/jit.mdx
+++ b/docs/advanced/jit.mdx
@@ -7,7 +7,7 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps
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-nightly.2025.04.15 also includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN and Wi-Fi or with mobile data and Wi-Fi disabled.
+As an alternative, SideStore 0.6.2-nightly.2025.04.15 also 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 enabled/connected or with mobile data and Wi-Fi disabled (Airplane Mode).
:::
## Prerequisites
From 2fdb33fd1f403d2f686f0d8969ae8590ca9bd735 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 18:45:57 -0600
Subject: [PATCH 16/78] Update troubleshooting.mdx
Removes AltStore-only issues, corrects capitalization & other grammar issues
---
docs/troubleshooting/troubleshooting.mdx | 45 ++++++++----------------
1 file changed, 14 insertions(+), 31 deletions(-)
diff --git a/docs/troubleshooting/troubleshooting.mdx b/docs/troubleshooting/troubleshooting.mdx
index e90e2271..0a83d319 100644
--- a/docs/troubleshooting/troubleshooting.mdx
+++ b/docs/troubleshooting/troubleshooting.mdx
@@ -5,19 +5,19 @@ description: A guide to troubleshooting SideStore.
## Installation
-#### I followed the instructions, but I still can't install Sidestore.
+#### I followed the instructions, but I still can't install SideStore.
### Mac Instructions
1. **Trust Device**: After connecting your iOS device to your Mac, ensure you have said “Trust” on both your Mac and iOS device. You can verify this by:
- Opening Finder (macOS 10.15 Catalina or later) or iTunes (macOS 10.14 Mojave and earlier).
- Disconnect and reconnect your phone to your mac and check 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.
+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:
- 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.
+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.
4. **Non-Microsoft Store Version of iTunes and iCloud**:
- If you installed iTunes or iCloud from the Microsoft Store, you’ll need to uninstall them.
- Download and install the non-Microsoft Store versions of iTunes and iCloud using the following links:
@@ -27,23 +27,23 @@ description: A guide to troubleshooting SideStore.
## Sign-In Issues
-#### Sidestore Freezing or Displaying an Error Code During Sign-In
+#### SideStore Freezing or Displaying an Error Code During Sign-In
-If you encounter freezing or error codes while attempting to sign in to Sidestore, there could be several potential causes. Follow these steps to resolve the issue:
+If you encounter freezing or error codes while attempting to sign in to SideStore, there could be several potential causes. Follow these steps to resolve the issue:
1. **Change the Anisette Server:**
The most common solution is to switch to a different Anisette server. Anisette servers may occasionally experience downtime. Switching to an alternative server typically resolves the issue. Do this:
- - Open Sidestore settings.
+ - Open SideStore settings.
- Scroll down to the "Anisette Server" option.
- Select a different server from the list.
- You might need to try a few servers from the list and find which works best for you.
2. **Host Your Own Anisette Server:**
- If you prefer, you can set up your own Anisette server. Detailed instructions for hosting an Anisette server are available in the official documentation and can he found [here](https://docs.sidestore.io/docs/advanced/anisette).
+ If you prefer, you can set up your own Anisette server. Detailed instructions for hosting an Anisette server are available in the official documentation and can be found [here](https://docs.sidestore.io/docs/advanced/anisette).
#### Verification Code Not Received When Signing In with Apple ID
-Another common issue during sign-in is not receiving a verification code when using your Apple ID with Sidestore. This can be resolved by following these steps:
+Another common issue during sign-in is not receiving a verification code when using your Apple ID with SideStore. This can be resolved by following these steps:
**For iOS versions below 18.1:**
@@ -61,7 +61,7 @@ Another common issue during sign-in is not receiving a verification code when us
- Select the bottom option, "Use Different Apple Account."
4. Enter your Apple ID and password.
5. Apple will send you a verification code.
- - Use this code in Sidestore to complete the sign-in process.
+ - Use this code in SideStore to complete the sign-in process.
## Can't Refresh or Install Apps
@@ -75,8 +75,7 @@ Another common issue during sign-in is not receiving a verification code when us
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.
- - 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).
- - After creating a new pairing file, go to Sidestore settings and press "Reset pairing file", then choose the new pairing file you just created.
+ - 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
@@ -85,24 +84,7 @@ Another common issue during sign-in is not receiving a verification code when us
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.
-
-
-## AltServer
-
-#### AltStore says “Could not find AltServer” when trying to sideload or refresh apps.
-
-AltServer must be running on a computer connected to the same Wi-Fi as AltStore in order to sideload or refresh apps. If AltServer is running on the same Wi-Fi network as AltStore and you're still receiving this error, try the following:
-
-- 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) Your 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.
-- 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.
-
-#### I’m unable to change my network settings to allow devices to communicate with each other (such as on school/work/public Wi-Fi).
-
-You can always sideload and refresh apps without Wi-Fi by plugging your iPhone or iPad into your computer. However, this means AltStore may not be able to refresh apps for you in the background over Wi-Fi.
+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
@@ -110,6 +92,7 @@ You can always sideload and refresh apps without Wi-Fi by plugging your iPhone o
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.
@@ -122,9 +105,9 @@ This could happen for a number of reasons. If you’re experiencing this issue,
If you can't find the answer to your question here, you can email [support@altstore.io](mailto:support@altstore.io), and they will try to get back to you as soon as they can.
:::
-#### What if I need to use the Windows Store version of iCloud?
+## What if I need to use the Windows Store version of iCloud?
-AltStore requires that you install iCloud directly from Apple in order to authenticate your Apple ID. If you want or need to use the Windows Store version as well, you can follow these alternate instructions copied from [this reddit post](https://www.reddit.com/r/jailbreak/comments/rp5buz/tutorial\_how\_to\_use\_altserver\_if\_you\_have\_to\_use/?utm\_source=share\&utm\_medium=ios\_app\&utm\_name=iossmf) and updated:
+AltServer requires that you install iCloud directly from Apple in order to authenticate your Apple ID. If you want or need to use the Windows Store version as well, you can follow these alternate instructions copied from [this reddit post](https://www.reddit.com/r/jailbreak/comments/rp5buz/tutorial\_how\_to\_use\_altserver\_if\_you\_have\_to\_use/?utm\_source=share\&utm\_medium=ios\_app\&utm\_name=iossmf) and updated:
1. Download and install [iTunes](https://www.apple.com/itunes/) from the official Apple website here ([64-bit](https://secure-appldnld.apple.com/itunes12/001-80053-20210422-E8A3B28C-A3B2-11EB-BE07-CE1B67FC6302/iTunes64Setup.exe) or [32-bit](https://secure-appldnld.apple.com/itunes12/001-80042-20210422-E8A351F2-A3B2-11EB-9A8F-CF1B67FC6302/iTunesSetup.exe).
2. Download and install iCloud from the official Apple website [here](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe).
From 90dbd5d019e685bc7939fe659d32f84b1fc9c7b1 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 20:59:39 -0600
Subject: [PATCH 17/78] Update app-sources.mdx
---
docs/advanced/app-sources.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/app-sources.mdx b/docs/advanced/app-sources.mdx
index 85a03633..8ea1476f 100644
--- a/docs/advanced/app-sources.mdx
+++ b/docs/advanced/app-sources.mdx
@@ -5,7 +5,7 @@ description: A guide on custom app sources.
# Make a Source
-SideStore is fully compatible with AltStore Sources (or AltSources). The official AltSource [documentation](https://faq.altstore.io/developers/make-a-source) provides all the details you need to make your own AltSource. AltSources allow your audience to view, install, and update all your available apps easily using either AltStore and SideStore.
+SideStore is fully compatible with AltStore Sources (or AltSources). The official AltSource [documentation](https://faq.altstore.io/developers/make-a-source) provides all the details you need to make your own AltSource. AltSources allow your audience to view, install, and update all your available apps easily. (FYI- After using AltStudio to create a source, you must remove the marketplaceID and Build fields for it to function properly, otherwise AltStore/SideStore will believe it to be a notarized source and prevent adding it)
Here are some recommended third-party tools that can assist in creating viewing your AltSources:
- You can use the community-built [AltStudio](https://altstudio.app/) (WIP) to generate you an AltSource automatically using an IPA!
From 1811da9e7d3e77681e208cbaf61c9c5391af7fb9 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Fri, 23 May 2025 21:12:07 -0600
Subject: [PATCH 18/78] Update pairing-file.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/pairing-file.mdx | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 64bf3887..2dd0fbd5 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -4,9 +4,9 @@ description: Pairing files are essential to SideStore's functionality.
sidebar_position: 2
---
-iDevicePair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
+iDevice Pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
-Download iDevicePair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe), [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg), or Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
+Download iDevice Pair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe), [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg), or Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
## Pairing Instructions
@@ -15,22 +15,22 @@ Download iDevicePair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_
1. Install iTunes from Apple's website ([64-bit](https://apple.com/itunes/download/win64) or [32-bit](https://apple.com/itunes/download/win32)).
2. Download `iDevicePair--windows-x86_64.exe` (move it somewhere you won't lose it).
3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
-4. Unlock your device, open iDevicePair, and select your device in the drop-down menu.
+4. Unlock your device, open iDevice Pair, and select your device in the drop-down menu.
5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
### macOS
-1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag "iDevicePair" to your Applications folder.
+1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag `iDevice Pair` to your Applications folder.
3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
-4. Unlock your device, open iDevicePair, and select your device in the drop-down menu.
+4. Unlock your device, open iDevice Pair, and select your device in the drop-down menu.
5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
### Linux
:::note
-The iDevicePair instructions for Linux are a work-in-progress, but iDevicePair is pretty intuitive, so you can give it a try if you want. For now, instructions to create a pairing file using JitterbugPair for Linux are below!
+The iDevice Pair instructions for Linux are a work-in-progress, but iDevice Pair is pretty intuitive, so you can give it a try without docs if you want. For now, instructions to create a pairing file using JitterbugPair for Linux are below!
:::
These instructions expect that you are familiar with the linux commandline.
From 89579d56a36dc117530a53a7f82be30fab3d8ccd Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 17:20:47 -0600
Subject: [PATCH 19/78] Update pairing-file.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/pairing-file.mdx | 52 +++++++++++++-----------------
1 file changed, 23 insertions(+), 29 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 2dd0fbd5..7c97324d 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -4,49 +4,43 @@ description: Pairing files are essential to SideStore's functionality.
sidebar_position: 2
---
-iDevice Pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
+"idevice pair" allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
-Download iDevice Pair for [Windows (64-bit)](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe), [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg), or Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
+Download idevice pair for:
+- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe)
+- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg)
+- Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
## Pairing Instructions
-### Windows
+### Windows (64-bit)
-1. Install iTunes from Apple's website ([64-bit](https://apple.com/itunes/download/win64) or [32-bit](https://apple.com/itunes/download/win32)).
+1. Install [iTunes](https://apple.com/itunes/download/win64) from Apple's website.
2. Download `iDevicePair--windows-x86_64.exe` (move it somewhere you won't lose it).
3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
-4. Unlock your device, open iDevice Pair, and select your device in the drop-down menu.
+4. Unlock your device, then, in File Explorer, open `idevice pair` and select your device in the drop-down menu.
5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
### macOS
-1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag `iDevice Pair` to your Applications folder.
-3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
-4. Unlock your device, open iDevice Pair, and select your device in the drop-down menu.
-5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
-6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
+1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag `idevice pair` to `Applications`.
+2. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
+3. Unlock your device, then open idevice pair and select your device in the drop-down menu.
+4. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
+5. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
### Linux
-:::note
-The iDevice Pair instructions for Linux are a work-in-progress, but iDevice Pair is pretty intuitive, so you can give it a try without docs if you want. For now, instructions to create a pairing file using JitterbugPair for Linux are below!
-:::
-
These instructions expect that you are familiar with the linux commandline.
-1. **Download** `jitterbugpair-linux.zip` from [here](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-linux.zip), then extract it.
-2. Open a terminal in the extracted directory.
-3. Make the program executable:
- ```bash
- chmod +x ./jitterbugpair
- ```
-4. **Set a passcode** for your device if you haven't already. Unlock your device and connect it to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
-5. Open your device to the homescreen.
-6. Execute the program:
- ```bash
- ./jitterbugpair
- ```
-7. The first time you execute the tool, you will get a prompt for your passcode on your secondary device. Type it in, then keep the screen on and unlocked and run the tool again. Type it in, then keep the screen on and unlocked and execute the tool again.
-8. JitterbugPair will generate a **pairing file** with the extension `.mobiledevicepairing`.
-9. Compress the file into a .zip folder. Then, **transfer the pairing file** to your iOS device using email, cloud storage, or another method you prefer.
+1. In the linux commandline, run the following code:
+```
+sudo apt update
+sudo apt install usbmuxd
+```
+2. Download the version of idevice pair that corresponds to your PC's architecture and make it executable.
+3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
+4. Unlock your device, then execute idevice pair and select your device in the drop-down menu.
+5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
+6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
From 8623df555c9168ac47881c89bd6ad48cd0ba8d4e Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:07:11 -0600
Subject: [PATCH 20/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 7c97324d..12011d37 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -1,7 +1,7 @@
---
title: Pairing File
description: Pairing files are essential to SideStore's functionality.
-sidebar_position: 2
+sidebar_position: 5
---
"idevice pair" allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
From 93fff2e4a8bb69a536a62126ae4f828c0e4b8fca Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:07:31 -0600
Subject: [PATCH 21/78] Update mac.mdx
---
docs/installation/mac.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index 3515baad..eea4d94a 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -1,7 +1,7 @@
---
title: macOS Instructions
description: Instructions for installing SideStore using macOS
-sidebar_position: 4
+sidebar_position: 2
---
Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites), and that you have a [pairing file](pairing-file)!
From b35114905d5fe276bdaa97047c09728b982302d9 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:07:41 -0600
Subject: [PATCH 22/78] Update linux.mdx
---
docs/installation/linux.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index 4d972e01..598e890d 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -1,7 +1,7 @@
---
title: Linux Instructions
description: Instructions for installing SideStore using Linux
-sidebar_position: 5
+sidebar_position: 4
---
To install SideStore (or any other IPA) on Linux, make sure you have Docker installed. Before you start, make sure to install StosVPN and any other and [prerequisites](prerequisites) that are satisfied!
From 91720b60bfe2f14b163907d850a111c6b8edd57c Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:09:42 -0600
Subject: [PATCH 23/78] Update windows.mdx
---
docs/installation/windows.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 3ddd8d65..22d31bed 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using Windows
sidebar_position: 3
---
-Please make sure that on your machine the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and iTunes ([64-bit](https://apple.com/itunes.download/win64) or [32-bit](https://apple.com/itunes.download/win32)) (iTunes should already be installed from the pairing guide section) are installed. Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites), and that you have a [Pairing File](pairing-file)!
+Please make sure that on your machine the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win6) (iTunes should already be installed from the pairing guide section) are installed. Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites)!
The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022. The above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers.
From 0835adde4f5c02f623dc2fa252a718fe2a29bda7 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:11:49 -0600
Subject: [PATCH 24/78] Update prerequisites.mdx
---
docs/installation/prerequisites.mdx | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx
index cd6a292a..748f4637 100644
--- a/docs/installation/prerequisites.mdx
+++ b/docs/installation/prerequisites.mdx
@@ -34,4 +34,7 @@ This VPN is required to be turned on any time you wish to install or update apps
## Next Steps
-Now, go to the next page to generate your pairing file!
+Now, follow the installation instructions for your operating system!
+- [macOS](mac)
+- [Windows (64-bit)](windows)
+- [Linux (experimental)](linux)
From 524b208b75897b9204ffa9f8c6e84de859134f01 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:14:38 -0600
Subject: [PATCH 25/78] Update mac.mdx
---
docs/installation/mac.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index eea4d94a..eb7f6a67 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -11,6 +11,6 @@ Before you start, make sure to have all steps completed found in the [Prerequisi
3. Hold option 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 on your secondary device.
* You can find this in Settings, under "General", and then "VPN & Device Management".
-5. Open SideStore, select your pairing file, and sign in with your Apple ID.
+5. Open SideStore and press allow on prompts until it asks for a pairing file, then stop.
-When you finish, follow the [post-install instructions](post-install).
+When you finish, proceed to generate your [pairing-file](pairing-file).
From e0db7430e85bbb3538996f8f63fd94c6379bc14a Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:16:07 -0600
Subject: [PATCH 26/78] Update windows.mdx
---
docs/installation/windows.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 22d31bed..65dbe42f 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -13,6 +13,6 @@ The non-Microsoft Store version of iCloud was removed from Apple’s website in
3. Hold shift and click on the AltServer tray icon. Click "Sideload .ipa", and select `sidestore.ipa`.
4. Approve the "Developer App" with your Apple ID's email.
* You can find this in Settings, under "General", and then "VPN & Device Management".
-5. Open SideStore, select your pairing file, and sign in with your Apple ID.
+5. Open SideStore and press allow on prompts until you reach a screen asking for your pairing file, then stop.
-After you finish, follow the [post-install instructions](post-install).
+After you finish, follow the instructions to generate a [pairing-file](pairing-file).
From 2611ee5f9c532702d6efea782b9326bad53dfda8 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:16:46 -0600
Subject: [PATCH 27/78] Update windows.mdx
---
docs/installation/windows.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 65dbe42f..e77c6d03 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -15,4 +15,4 @@ The non-Microsoft Store version of iCloud was removed from Apple’s website in
* You can find this in Settings, under "General", and then "VPN & Device Management".
5. Open SideStore and press allow on prompts until you reach a screen asking for your pairing file, then stop.
-After you finish, follow the instructions to generate a [pairing-file](pairing-file).
+After you finish, proceed to generate your [pairing-file](pairing-file).
From e4d65755bc872ccc7c12604d8d5d0875cbb5fc02 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:20:11 -0600
Subject: [PATCH 28/78] Update linux.mdx
---
docs/installation/linux.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index 598e890d..ead5cf2b 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -18,4 +18,4 @@ podman run --privileged --rm -it -e ALTSERVER_ANISETTE_SERVER="https://ani.sides
Altcon will start to pair with your device, plug it in if you haven't. Press "trust" and enter your passcode.
-When you finish, then follow the [post-install instructions](post-install).
+When you finish, proceed to generate your [pairing-file](pairing-file).
From 37e8251d766fdcc633bc25eea0a5fa29716bd3eb Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:20:33 -0600
Subject: [PATCH 29/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 12011d37..6604c477 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -4,7 +4,7 @@ description: Pairing files are essential to SideStore's functionality.
sidebar_position: 5
---
-"idevice pair" allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
+idevice_pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
Download idevice pair for:
- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe)
From d22b9fee05851913022a0cb85e84de7c36f6685a Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:21:55 -0600
Subject: [PATCH 30/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 3 +++
1 file changed, 3 insertions(+)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 6604c477..fdb28ef6 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -44,3 +44,6 @@ sudo apt install usbmuxd
4. Unlock your device, then execute idevice pair and select your device in the drop-down menu.
5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
+
+## Next steps
+Now, follow the [post-install instructions](post-install).
\ No newline at end of file
From 19a884b1e9d4380c374946e6f1295c396b1bb7bc Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 20:23:00 -0600
Subject: [PATCH 31/78] Update post-install.mdx
---
docs/installation/post-install.mdx | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/docs/installation/post-install.mdx b/docs/installation/post-install.mdx
index 13ed303f..29e587f7 100644
--- a/docs/installation/post-install.mdx
+++ b/docs/installation/post-install.mdx
@@ -9,9 +9,10 @@ To do this, you need to:
1. Connect to StosVPN.
2. Open SideStore.
-3. If you haven't already, select the pairing file.
-4. Navigate to "My Apps".
-5. Select the "x DAYS" button, (x is the number of days until expiry). A prompt asking about your signing certificate should appear, tap "Refresh Now". If a prompt appears asking you if you want to revoke a certificate from AltStore, tap "yes".
+3. Sign in to your Apple ID.
+4. If you haven't already, select the pairing file.
+5. Navigate to "My Apps".
+6. Select the "x DAYS" button, (x is the number of days until an app's expiry). A prompt asking about your signing certificate should appear, tap "Refresh Now". If a prompt appears asking you if you want to revoke a certificate from AltStore, tap "yes".
* If successful, this will open a blank Safari tab or open to your home screen, accompanied by a notification notating this.
If SideStore is not refreshed, a bug causing early expiry will require you to reinstall SideStore. There is a plan to have this done automatically, but for now it needs to be done manually.
From a5492b91c06d3b76cd061077f9cba9f76b47351c Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:39:42 -0600
Subject: [PATCH 32/78] Update sidebars.js
---
sidebars.js | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/sidebars.js b/sidebars.js
index 172763cd..87772bde 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -20,13 +20,12 @@ const sidebars = {
tutorialSidebar: [
'intro',
- 'release-notes',
- 'faq',
{
type: 'category',
label: 'Installation',
- items: ['installation/prerequisites', 'installation/pairing-file', 'installation/windows', 'installation/mac', 'installation/linux', 'installation/post-install'],
+ items: ['installation/prerequisites', 'installation/mac', 'installation/windows', 'installation/linux', 'installation/pairing-file', 'installation/post-install'],
},
+ 'faq',
{
type: 'category',
label: 'Troubleshooting',
@@ -37,6 +36,7 @@ const sidebars = {
label: 'Advanced',
items: ['advanced/anisette', 'advanced/app-sources', 'advanced/url-schema', 'advanced/sparserestore', 'advanced/jit'],
},
+ 'release-notes',
],
};
From b5545bd6b87eccf27194365a5eb33dd9b6844dee Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:42:25 -0600
Subject: [PATCH 33/78] Update release-notes.mdx
---
docs/release-notes.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/release-notes.mdx b/docs/release-notes.mdx
index 0f232e3f..c03f67a1 100644
--- a/docs/release-notes.mdx
+++ b/docs/release-notes.mdx
@@ -1,7 +1,7 @@
---
title: Release Notes
description: A collection of SideStore release notes.
-sidebar_position: 2
+sidebar_position: 6
---
# Stable Notes
From de80f43c2130c89ef70060189d8b62b0e968aec1 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:43:34 -0600
Subject: [PATCH 34/78] Update mac.mdx
---
docs/installation/mac.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index eb7f6a67..f7eb32ff 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using macOS
sidebar_position: 2
---
-Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites), and that you have a [pairing file](pairing-file)!
+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 AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your `Applications` folder, then open it (using Finder, Launchpad, or Spotlight). It should appear as an icon in your menu bar.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
@@ -13,4 +13,4 @@ Before you start, make sure to have all steps completed found in the [Prerequisi
* You can find this in Settings, under "General", and then "VPN & Device Management".
5. Open SideStore and press allow on prompts until it asks for a pairing file, then stop.
-When you finish, proceed to generate your [pairing-file](pairing-file).
+When you finish, proceed to generate your [pairing file](pairing-file).
From 664bf25720d97ed7acf945f4851f8b5a93a92721 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:44:11 -0600
Subject: [PATCH 35/78] Update linux.mdx
---
docs/installation/linux.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index ead5cf2b..ea756666 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -18,4 +18,4 @@ podman run --privileged --rm -it -e ALTSERVER_ANISETTE_SERVER="https://ani.sides
Altcon will start to pair with your device, plug it in if you haven't. Press "trust" and enter your passcode.
-When you finish, proceed to generate your [pairing-file](pairing-file).
+When you finish, proceed to generate your [pairing file](pairing-file).
From 2daf643122e652c3b19b97033cf49c6ef8db80c4 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:44:50 -0600
Subject: [PATCH 36/78] Update mac.mdx
---
docs/installation/mac.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index f7eb32ff..6639e4cd 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using macOS
sidebar_position: 2
---
-Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites), and that you have a [pairing file](pairing-file)!
+Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
1. Download AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your `Applications` folder, then open it (using Finder, Launchpad, or Spotlight). It should appear as an icon in your menu bar.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
From 189ab33c48ddf3dbd3f57ce165136ea91385c269 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:45:40 -0600
Subject: [PATCH 37/78] Update windows.mdx
---
docs/installation/windows.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index e77c6d03..322f8a05 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using Windows
sidebar_position: 3
---
-Please make sure that on your machine the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win6) (iTunes should already be installed from the pairing guide section) are installed. Before you start, make sure to have all steps completed found in the [Prerequisites](prerequisites)!
+Please make sure that on your machine the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win6) (iTunes should already be installed from the pairing guide section) are installed. Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022. The above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers.
From 5bb9c46622f49ce15187017122d7ce18837ca1d2 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 22:46:35 -0600
Subject: [PATCH 38/78] Update linux.mdx
---
docs/installation/linux.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index ea756666..f5f52070 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using Linux
sidebar_position: 4
---
-To install SideStore (or any other IPA) on Linux, make sure you have Docker installed. Before you start, make sure to install StosVPN and any other and [prerequisites](prerequisites) that are satisfied!
+To install SideStore (or any other IPA) on Linux, make sure you have Docker installed. Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
1. Run altcon with Docker
```bash
From b4c515317da063093f6cae6997146ba88923e427 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 23:00:04 -0600
Subject: [PATCH 39/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index fdb28ef6..406dfe6d 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -7,9 +7,9 @@ sidebar_position: 5
idevice_pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
Download idevice pair for:
-- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe)
- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg)
-- Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage)).
+- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe)
+- Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage))
## Pairing Instructions
From ce4a94f79a9fc45d28c9cfbbad6dad3c1a9ee3b4 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 23:00:17 -0600
Subject: [PATCH 40/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 406dfe6d..b3df3cbe 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -6,7 +6,7 @@ sidebar_position: 5
idevice_pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
-Download idevice pair for:
+Download idevice_pair for:
- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg)
- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe)
- Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage))
From 17a65523f8adec7b75426de769cd31ac121ce59e Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 23:00:58 -0600
Subject: [PATCH 41/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index b3df3cbe..8afeb248 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -13,6 +13,14 @@ Download idevice_pair for:
## Pairing Instructions
+### macOS
+
+1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag `idevice pair` to `Applications`.
+2. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
+3. Unlock your device, then open idevice pair and select your device in the drop-down menu.
+4. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
+5. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
+
### Windows (64-bit)
1. Install [iTunes](https://apple.com/itunes/download/win64) from Apple's website.
@@ -22,14 +30,6 @@ Download idevice_pair for:
5. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
-### macOS
-
-1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag `idevice pair` to `Applications`.
-2. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
-3. Unlock your device, then open idevice pair and select your device in the drop-down menu.
-4. Ensure your device is unlocked and opened to the home screen, then select "generate". When a prompt appears on your device, tap "trust". Your pairing file should appear.
-5. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
-
### Linux
These instructions expect that you are familiar with the linux commandline.
From 6d328ad9ca605b654b24fc8b1c27ac888edaff7a Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 24 May 2025 23:04:48 -0600
Subject: [PATCH 42/78] Update windows.mdx
---
docs/installation/windows.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 322f8a05..19fd260f 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -15,4 +15,4 @@ The non-Microsoft Store version of iCloud was removed from Apple’s website in
* You can find this in Settings, under "General", and then "VPN & Device Management".
5. Open SideStore and press allow on prompts until you reach a screen asking for your pairing file, then stop.
-After you finish, proceed to generate your [pairing-file](pairing-file).
+After you finish, proceed to generate your [pairing file](pairing-file).
From 7764e9a2d60efa308079667751798724bfdc0ca9 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 11:37:03 -0600
Subject: [PATCH 43/78] Update faq.mdx
---
docs/faq.mdx | 4 ----
1 file changed, 4 deletions(-)
diff --git a/docs/faq.mdx b/docs/faq.mdx
index ac209a3e..953ed99e 100644
--- a/docs/faq.mdx
+++ b/docs/faq.mdx
@@ -40,10 +40,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.
-### I cannot connect to the internet when the VPN is on
-
-Make sure you don't have an alternate DNS set up in your Wi-Fi and WireGuard configuration. If you know the DNS IP address works, then try removing it from your Wi-Fi configuration and adding it into the WireGuard config under DNS.
-
### 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).
From a41af40821c3cbfbbaf4d37aee76af6c7d97959c Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 11:38:40 -0600
Subject: [PATCH 44/78] Update common-issues.mdx
---
docs/troubleshooting/common-issues.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/troubleshooting/common-issues.mdx b/docs/troubleshooting/common-issues.mdx
index c81601c9..c95f228e 100644
--- a/docs/troubleshooting/common-issues.mdx
+++ b/docs/troubleshooting/common-issues.mdx
@@ -16,7 +16,7 @@ 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 a new pairing file using JitterbugPair and import it via the settings menu. 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
@@ -26,7 +26,7 @@ Connection issues with the minimuxer service.
2. Try again (spamming the button usually helps)
3. Restart SideStore
4. Restart StosVPN
-5. Generate a new pairing file using JitterbugPair and import it via the settings menu. See our [Pairing File instructions](/docs/installation/pairing-file) for details.
+5. Generate 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
#### Cause
From 1940aaf99cbba9f0d8120363d1a8ff885e4a3b3d Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 17:09:20 -0600
Subject: [PATCH 45/78] Update intro.mdx
---
i18n/es/docusaurus-plugin-content-docs/current/intro.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx b/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx
index 0d3fafdb..62591493 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx
+++ b/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx
@@ -4,7 +4,7 @@ titulo: Intro de SideStore
# Intro de SideStore
-:::Peligro
+:::Danger
This documentation is currently not fully translated into Spanish. Please consider helping us by translating our docs!
From 76cd9a78e4ea724401f39c0abb3e04dc87ea8296 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 17:09:55 -0600
Subject: [PATCH 46/78] Update intro.mdx
---
i18n/es/docusaurus-plugin-content-docs/current/intro.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx b/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx
index 62591493..447a169f 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx
+++ b/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx
@@ -4,7 +4,7 @@ titulo: Intro de SideStore
# Intro de SideStore
-:::Danger
+:::danger
This documentation is currently not fully translated into Spanish. Please consider helping us by translating our docs!
From e4166338b95aba2c1deb3a8b4b334c7c31baf5c4 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 17:12:35 -0600
Subject: [PATCH 47/78] Update anisette.mdx
---
.../current/advanced/anisette.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/advanced/anisette.mdx b/i18n/es/docusaurus-plugin-content-docs/current/advanced/anisette.mdx
index 37646b57..f512afca 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/advanced/anisette.mdx
+++ b/i18n/es/docusaurus-plugin-content-docs/current/advanced/anisette.mdx
@@ -3,7 +3,7 @@ titulo: Anisette Server Personalizado
descripción: Una Guia sobre anisette servers.
---
-:::nota
+:::note
Al usar cualquier version de SideStore despues de la versión 0.4.0 es improbable que se bloquee tu cuenta ya que en esa version se añadio soporte a los servers anisette v3.
Con esto en cuenta es **altamente recomendado** usar un server v3 para usar SideStore sin inconveniencias, si tu versión lo soporta.
From 611e1f2e5de653a03b5b5757abe95f216a5d814e Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 17:13:17 -0600
Subject: [PATCH 48/78] Update sparserestore.mdx
---
.../current/advanced/sparserestore.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/advanced/sparserestore.mdx b/i18n/es/docusaurus-plugin-content-docs/current/advanced/sparserestore.mdx
index 757fa7dc..7dd83da3 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/advanced/sparserestore.mdx
+++ b/i18n/es/docusaurus-plugin-content-docs/current/advanced/sparserestore.mdx
@@ -3,7 +3,7 @@ titulo: sobrepasar el limite de 3 apps
description: Un tutorial sobre como instalar más de 3 apps atraves de SideStore usando el exploit de SparseRestore.
---
-:::nota
+:::note
El exploit de "Sobrepasar el limite de 3 apps" de SparseRestore, **solo funciona en versiones de iOS/iPadOS entre 17.0 y 18.1 beta 4 (sin incluir 17.7.1)** Si no estas en estas versiones y no funciona, **porfavor no pidas soporte sobre esto**.
From bcec113d145de891e1223c21ace7204909de10bb Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 17:13:48 -0600
Subject: [PATCH 49/78] Update jit.mdx
---
i18n/es/docusaurus-plugin-content-docs/current/advanced/jit.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/advanced/jit.mdx b/i18n/es/docusaurus-plugin-content-docs/current/advanced/jit.mdx
index 2e79a158..251a211e 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/advanced/jit.mdx
+++ b/i18n/es/docusaurus-plugin-content-docs/current/advanced/jit.mdx
@@ -3,7 +3,7 @@ titulo: Activar JIT
descripción: Un tutorial sobre como activar la compilación Just-In-Time (JIT) para las apps que lo necesitan.
---
-:::nota
+:::note
Hay muchos metodos para activar JIT, como AltJIT, SideJITServer, y mas. Este tutorial hablara sobre como usar StikJIT/StikDebug, porque es el metodo que actulmente recomendamos. Como alternativa, Sidestore 0.6.2-nightly.2025.04.15 tambien incluye actualizaciones para minimuxer, permitiendo una JIT ya incorporado que funciona de forma similar a StikDebug. Para usar esto, simplemente asegurate de que estas conectado a StosVPN y al Wi-FI o también a los datos móviles.
:::
From a88296ca93d0462c280cac65d649e5b048c64d84 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 17:48:41 -0600
Subject: [PATCH 50/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 8afeb248..ecc5e71e 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -4,9 +4,9 @@ description: Pairing files are essential to SideStore's functionality.
sidebar_position: 5
---
-idevice_pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
+idevice pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
-Download idevice_pair for:
+Download idevice pair for:
- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg)
- [Windows](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--windows-x86_64.exe)
- Linux ([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-x86_64.AppImage) or [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--linux-aarch64.AppImage))
From da2d3ef6ee31616f72b0eaa6709e9683bd66858f Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Mon, 26 May 2025 22:03:34 -0600
Subject: [PATCH 51/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index ecc5e71e..488dabb5 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -36,8 +36,7 @@ These instructions expect that you are familiar with the linux commandline.
1. In the linux commandline, run the following code:
```
-sudo apt update
-sudo apt install usbmuxd
+sudo apt install -y usbmuxd
```
2. Download the version of idevice pair that corresponds to your PC's architecture and make it executable.
3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
From 53185ce6e3e2895956658cdc1cdce83f8f4e24de Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 12:03:21 -0600
Subject: [PATCH 52/78] Update prerequisites.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/prerequisites.mdx | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx
index b0485e01..d439b846 100644
--- a/docs/installation/prerequisites.mdx
+++ b/docs/installation/prerequisites.mdx
@@ -10,11 +10,12 @@ SideStore's installation process may seem tricky, but with the ***one-time*** us
To install SideStore, you will need:
-- An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher.
-- A [Windows](/docs/installation/windows.mdx), [Mac](/docs/installation/mac.mdx), or [Linux (Linux support is experimental)](/docs/installation/linux.mdx) computer.
-- An Apple ID.
-- The StosVPN app.
-- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/troubleshooting/)).
+- An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher
+- A [Mac](/docs/installation/mac), [Windows](/docs/installation/windows), or [Linux (Linux support is experimental)](/docs/installation/linux) computer
+- An Apple ID
+- The StosVPN app
+- A Wi-Fi connection
+- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/troubleshooting/))
Users of iOS/iPadOS 16 or higher *must* have Developer Mode enabled. Do this by:
1. Open the Settings app.
@@ -30,7 +31,7 @@ SideStore utilizes an on-device VPN which allows SideStore to communicate with i
1. Download the StosVPN app from the [Apple App Store](https://apps.apple.com/us/app/stosvpn/id6744003051).
2. Enable the VPN.
-This VPN is required to be turned on any time you wish to install or update apps in SideStore.
+This VPN is required to be turned on any time you wish to install, update, or refresh apps in SideStore.
## Next Steps
From 7b2661306f4c51ced017ac991d0b428200dfa591 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 12:24:30 -0600
Subject: [PATCH 53/78] Update app-sources.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/advanced/app-sources.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/advanced/app-sources.mdx b/docs/advanced/app-sources.mdx
index 8ea1476f..50ee32d7 100644
--- a/docs/advanced/app-sources.mdx
+++ b/docs/advanced/app-sources.mdx
@@ -5,10 +5,10 @@ description: A guide on custom app sources.
# Make a Source
-SideStore is fully compatible with AltStore Sources (or AltSources). The official AltSource [documentation](https://faq.altstore.io/developers/make-a-source) provides all the details you need to make your own AltSource. AltSources allow your audience to view, install, and update all your available apps easily. (FYI- After using AltStudio to create a source, you must remove the marketplaceID and Build fields for it to function properly, otherwise AltStore/SideStore will believe it to be a notarized source and prevent adding it)
+SideStore is fully compatible with AltStore Sources (or AltSources). The official AltSource [documentation](https://faq.altstore.io/developers/make-a-source) provides all the details you need to make your own AltSource. AltSources allow your audience to view, install, and update all your available apps easily.
Here are some recommended third-party tools that can assist in creating viewing your AltSources:
-- You can use the community-built [AltStudio](https://altstudio.app/) (WIP) to generate you an AltSource automatically using an IPA!
+- You can use the community-built [AltStudio](https://altstudio.app/) (WIP) to generate you an AltSource automatically using an IPA! (Caution- After using AltStudio to create a source, you must remove the autogenerated-by-default marketplaceID and Build fields, otherwise SideStore will believe it to be a notarized source and prevent your source being added)
- You can use the community-built [AltSource Browser](https://altsource.by.lao.sb/browse/) to view a visual display of your updates to an AltSource draft before finalizing your changes, allowing you to correct any errors before publishing them!
# Distributing your Source
From 398bb8138a5f9569ce5241c3c3f8b946543f41fc Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:25:32 -0600
Subject: [PATCH 54/78] Update mac.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/mac.mdx | 9 ++++++---
1 file changed, 6 insertions(+), 3 deletions(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index 6639e4cd..fd24bde9 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -9,8 +9,11 @@ Before you start, make sure to have all steps completed found in the [prerequisi
1. Download AltServer from [AltStore's website](https://cdn.altstore.io/file/altstore/altserver.zip). Copy AltServer.app to your `Applications` folder, then open it (using Finder, Launchpad, or Spotlight). It should appear as an icon in your menu bar.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
3. Hold option 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 on your secondary device.
- * You can find this in Settings, under "General", and then "VPN & Device Management".
-5. Open SideStore and press allow on prompts until it asks for a pairing file, then stop.
+4. On your secondary device, do the following:
+ * Approve the "Developer App" under your Apple ID's email (you can find this in Settings, under "General", and then "VPN & Device Management").
+ * Open the Settings app.
+ * Navigate to the 'Privacy and Security' section.
+ * Turn on 'Developer Mode' at the bottom.
+5. Open SideStore and press "Allow" on prompts until it asks for a pairing file, then exit the app.
When you finish, proceed to generate your [pairing file](pairing-file).
From baaa18a2807fef2e6635c567461dafe552f32037 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:25:54 -0600
Subject: [PATCH 55/78] Update windows.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/windows.mdx | 9 ++++++---
1 file changed, 6 insertions(+), 3 deletions(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 19fd260f..4af4961b 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -11,8 +11,11 @@ The non-Microsoft Store version of iCloud was removed from Apple’s website in
1. Download `altinstaller.zip` from [AltStore's website](https://cdn.altstore.io/file/altstore/altinstaller.zip). Extract `altinstaller.zip` and run `setup.exe`. In your Windows taskbar, type in "AltServer" and click "Run as administrator." Make sure to allow access to private networks if prompted. AltStore will appear as an icon in the tray.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
3. Hold shift and click on the AltServer tray icon. Click "Sideload .ipa", and select `sidestore.ipa`.
-4. Approve the "Developer App" with your Apple ID's email.
- * You can find this in Settings, under "General", and then "VPN & Device Management".
-5. Open SideStore and press allow on prompts until you reach a screen asking for your pairing file, then stop.
+4. On your secondary device, do the following:
+ * Approve the "Developer App" under your Apple ID's email (you can find this in Settings, under "General", and then "VPN & Device Management").
+ * Open the Settings app.
+ * Navigate to the 'Privacy and Security' section.
+ * Turn on 'Developer Mode' at the bottom.
+5. Open SideStore and press "Allow" on prompts until it asks for a pairing file, then exit the app.
After you finish, proceed to generate your [pairing file](pairing-file).
From ba3a10f9f91c8d1d1786482098f8cd247733a6b3 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:27:12 -0600
Subject: [PATCH 56/78] Update linux.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/linux.mdx | 21 ++++++++++++++-------
1 file changed, 14 insertions(+), 7 deletions(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index f5f52070..659c13fd 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -6,16 +6,23 @@ sidebar_position: 4
To install SideStore (or any other IPA) on Linux, make sure you have Docker installed. Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
-1. Run altcon with Docker
+1. The following will install usbmuxd and docker. Run these as a non-root user and you only have to do this once.
```bash
-docker run --rm -it -e ALTSERVER_ANISETTE_SERVER="https://ani.sidestore.io/" -v ${PWD}/:/mnt/ -v /var/run:/var/run ghcr.io/sidestore/altcon
+sudo apt install -y usbmuxd
+curl -fsSL https://test.docker.com -o test-docker.sh
+sudo sh test-docker.sh
+sudo usermod -aG docker $USER
```
-
-You can also run altcon with Podman
+2. Restart your shell to ensure changes are made. Now, plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. Now, run Altcon with Docker using this code:
```bash
-podman run --privileged --rm -it -e ALTSERVER_ANISETTE_SERVER="https://ani.sidestore.io/" -v ${PWD}/:/mnt/ -v /var/run:/var/run ghcr.io/sidestore/altcon
+docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon
```
-
-Altcon will start to pair with your device, plug it in if you haven't. Press "trust" and enter your passcode.
+3. Altcon will pair with your device. When you recieve another prompt, select "trust" and enter your passcode again.
+4. On your secondary device, do the following:
+ * Approve the "Developer App" under your Apple ID's email (you can find this in Settings, under "General", and then "VPN & Device Management").
+ * Open the Settings app.
+ * Navigate to the 'Privacy and Security' section.
+ * Turn on 'Developer Mode' at the bottom.
+5. Open SideStore and select "allow" for prompts until SideStore for a pairing file. Exit the app now.
When you finish, proceed to generate your [pairing file](pairing-file).
From 8d1973f7032ae914c1db42e4be95f5d45b4b7b79 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:27:54 -0600
Subject: [PATCH 57/78] Update windows.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/windows.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 4af4961b..a076280e 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -16,6 +16,6 @@ The non-Microsoft Store version of iCloud was removed from Apple’s website in
* Open the Settings app.
* Navigate to the 'Privacy and Security' section.
* Turn on 'Developer Mode' at the bottom.
-5. Open SideStore and press "Allow" on prompts until it asks for a pairing file, then exit the app.
+5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now.
-After you finish, proceed to generate your [pairing file](pairing-file).
+Now, proceed to generate your [pairing file](pairing-file).
From c0e76985ffe62df9329f0f205b917bf3a1c6f0c6 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:28:11 -0600
Subject: [PATCH 58/78] Update linux.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/linux.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index 659c13fd..e4ad9e6f 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -23,6 +23,6 @@ docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.i
* Open the Settings app.
* Navigate to the 'Privacy and Security' section.
* Turn on 'Developer Mode' at the bottom.
-5. Open SideStore and select "allow" for prompts until SideStore for a pairing file. Exit the app now.
+5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now.
-When you finish, proceed to generate your [pairing file](pairing-file).
+Now, proceed to generate your [pairing file](pairing-file).
From 5c8efa71d58b9210113d3bc9e0ef09d8ebc86ec5 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:28:25 -0600
Subject: [PATCH 59/78] Update mac.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/mac.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx
index fd24bde9..59ae94c4 100644
--- a/docs/installation/mac.mdx
+++ b/docs/installation/mac.mdx
@@ -14,6 +14,6 @@ Before you start, make sure to have all steps completed found in the [prerequisi
* Open the Settings app.
* Navigate to the 'Privacy and Security' section.
* Turn on 'Developer Mode' at the bottom.
-5. Open SideStore and press "Allow" on prompts until it asks for a pairing file, then exit the app.
+5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now.
-When you finish, proceed to generate your [pairing file](pairing-file).
+Now, proceed to generate your [pairing file](pairing-file).
From 0ef7feb8a864251cb144e140219f2f5c550bff1b Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:30:39 -0600
Subject: [PATCH 60/78] Update pairing-file.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/pairing-file.mdx | 8 +++-----
1 file changed, 3 insertions(+), 5 deletions(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 488dabb5..21c0275d 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -23,7 +23,7 @@ Download idevice pair for:
### Windows (64-bit)
-1. Install [iTunes](https://apple.com/itunes/download/win64) from Apple's website.
+1. If not already installed for AltServer, install [iTunes](https://apple.com/itunes/download/win64) from Apple's website.
2. Download `iDevicePair--windows-x86_64.exe` (move it somewhere you won't lose it).
3. Connect your secondary device to your computer via cable. If a prompt appears, tap "trust" and type in your passcode.
4. Unlock your device, then, in File Explorer, open `idevice pair` and select your device in the drop-down menu.
@@ -32,9 +32,7 @@ Download idevice pair for:
### Linux
-These instructions expect that you are familiar with the linux commandline.
-
-1. In the linux commandline, run the following code:
+1. If not already installed for Altcon, in the linux commandline, run the following code to install usbmuxd:
```
sudo apt install -y usbmuxd
```
@@ -45,4 +43,4 @@ sudo apt install -y usbmuxd
6. Ensure your device is still open to the home screen, then scroll down to the SideStore section and select "install". The word "success" should appear in green.
## Next steps
-Now, follow the [post-install instructions](post-install).
\ No newline at end of file
+Now, follow the [post-install instructions](post-install).
From bbfc75b05b707d019b80cac18e390f6e31124440 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:31:04 -0600
Subject: [PATCH 61/78] Update linux.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/linux.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index e4ad9e6f..6de8b93e 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using Linux
sidebar_position: 4
---
-To install SideStore (or any other IPA) on Linux, make sure you have Docker installed. Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
+Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
1. The following will install usbmuxd and docker. Run these as a non-root user and you only have to do this once.
```bash
From 6f280924fafe63671854ef4f262f0a084deac5df Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:31:34 -0600
Subject: [PATCH 62/78] Update windows.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/windows.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index a076280e..73ecd23d 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -4,7 +4,7 @@ description: Instructions for installing SideStore using Windows
sidebar_position: 3
---
-Please make sure that on your machine the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win6) (iTunes should already be installed from the pairing guide section) are installed. Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
+On your machine, install the the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win64). Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022. The above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers.
From 6a14f08fe79ba4df51fa356d1a050f43f98f1d96 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:32:22 -0600
Subject: [PATCH 63/78] Update windows.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/windows.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 73ecd23d..756663f9 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -4,9 +4,9 @@ description: Instructions for installing SideStore using Windows
sidebar_position: 3
---
-On your machine, install the the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win64). Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
+Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
-The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022. The above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers.
+On your machine, install the the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win64). The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022, so the above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers (safe).
1. Download `altinstaller.zip` from [AltStore's website](https://cdn.altstore.io/file/altstore/altinstaller.zip). Extract `altinstaller.zip` and run `setup.exe`. In your Windows taskbar, type in "AltServer" and click "Run as administrator." Make sure to allow access to private networks if prompted. AltStore will appear as an icon in the tray.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
From bbcb5966f6de01d972e4f757e5ce94c082b2059d Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:33:06 -0600
Subject: [PATCH 64/78] Update windows.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/windows.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 756663f9..c31e0909 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -6,7 +6,7 @@ sidebar_position: 3
Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
-On your machine, install the the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win64). The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022, so the above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers (safe).
+On your machine, uninstall any version of iCloud or iTunes you may have downloaded from the Microsoft store, then install the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win64). The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022, so the above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers (safe).
1. Download `altinstaller.zip` from [AltStore's website](https://cdn.altstore.io/file/altstore/altinstaller.zip). Extract `altinstaller.zip` and run `setup.exe`. In your Windows taskbar, type in "AltServer" and click "Run as administrator." Make sure to allow access to private networks if prompted. AltStore will appear as an icon in the tray.
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
From 3a37c81a526e5b7ce0f5775098934e3f615b127b Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:34:40 -0600
Subject: [PATCH 65/78] Update windows.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/windows.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index c31e0909..fd257110 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -8,9 +8,9 @@ Before you start, make sure to have all steps completed found in the [prerequisi
On your machine, uninstall any version of iCloud or iTunes you may have downloaded from the Microsoft store, then install the non-Microsoft Store versions of [iCloud](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) and [iTunes](https://apple.com/itunes.download/win64). The non-Microsoft Store version of iCloud was removed from Apple’s website in mid-September 2022, so the above link directs to an older version of iCloud that is still compatible with AltServer, and still available directly from Apple’s servers (safe).
-1. Download `altinstaller.zip` from [AltStore's website](https://cdn.altstore.io/file/altstore/altinstaller.zip). Extract `altinstaller.zip` and run `setup.exe`. In your Windows taskbar, type in "AltServer" and click "Run as administrator." Make sure to allow access to private networks if prompted. AltStore will appear as an icon in the tray.
+1. Download `altinstaller.zip` from [AltStore's website](https://cdn.altstore.io/file/altstore/altinstaller.zip). Extract `altinstaller.zip` and run `setup.exe`. In your Windows taskbar, type in "AltServer" and click "Run as administrator." Make sure to allow access to private networks if prompted. AltStore will appear as an icon in the system tray (where Internet, Wi-Fi, Battery, etc. are displayed).
2. Download the SideStore IPA which you can find [here](https://github.com/sidestore/sidestore/releases/latest/download/sidestore.ipa).
-3. Hold shift and click on the AltServer tray icon. Click "Sideload .ipa", and select `sidestore.ipa`.
+3. Hold shift and click on the AltServer tray icon. Click "Sideload .ipa", and select the `sidestore.ipa` you previously downloaded.
4. On your secondary device, do the following:
* Approve the "Developer App" under your Apple ID's email (you can find this in Settings, under "General", and then "VPN & Device Management").
* Open the Settings app.
From 473e0b7308d79a5c0f1d755f856c3342bd9ba0f9 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:35:31 -0600
Subject: [PATCH 66/78] Update prerequisites.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/prerequisites.mdx | 13 +++----------
1 file changed, 3 insertions(+), 10 deletions(-)
diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx
index d439b846..64af168c 100644
--- a/docs/installation/prerequisites.mdx
+++ b/docs/installation/prerequisites.mdx
@@ -11,19 +11,12 @@ SideStore's installation process may seem tricky, but with the ***one-time*** us
To install SideStore, you will need:
- An iPhone or iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher
-- A [Mac](/docs/installation/mac), [Windows](/docs/installation/windows), or [Linux (Linux support is experimental)](/docs/installation/linux) computer
+- A [Mac](/docs/installation/mac), [Windows](/docs/installation/windows), or [Linux](/docs/installation/linux) (Linux support is experimental) computer
- An Apple ID
-- The StosVPN app
+- The StosVPN app (see below)
- A Wi-Fi connection
- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/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.
-3. Turn on 'Developer Mode' at the bottom.
-
-> **Note:** You will only see the 'Developer Mode' option after you have successfully installed SideStore.
-
## StosVPN
SideStore utilizes an on-device VPN which allows SideStore to communicate with internal services.
@@ -35,7 +28,7 @@ This VPN is required to be turned on any time you wish to install, update, or re
## Next Steps
-Now, follow the installation instructions for your operating system!
+Next, follow the installation instructions for your operating system!
- [macOS](mac)
- [Windows (64-bit)](windows)
- [Linux (experimental)](linux)
From 0b6edff418623f4e0ba61f04497a4c6e51e93df0 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:37:58 -0600
Subject: [PATCH 67/78] Update post-install.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/post-install.mdx | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/docs/installation/post-install.mdx b/docs/installation/post-install.mdx
index 29e587f7..eea42b45 100644
--- a/docs/installation/post-install.mdx
+++ b/docs/installation/post-install.mdx
@@ -9,12 +9,12 @@ To do this, you need to:
1. Connect to StosVPN.
2. Open SideStore.
-3. Sign in to your Apple ID.
-4. If you haven't already, select the pairing file.
+3. If you haven't already, select your pairing file.
+4. Sign in with your Apple ID.
5. Navigate to "My Apps".
-6. Select the "x DAYS" button, (x is the number of days until an app's expiry). A prompt asking about your signing certificate should appear, tap "Refresh Now". If a prompt appears asking you if you want to revoke a certificate from AltStore, tap "yes".
- * If successful, this will open a blank Safari tab or open to your home screen, accompanied by a notification notating this.
+6. Tap the "x DAYS" button to the right of SideStore, (x is the number of days until an app's expiry). A prompt asking about your signing certificate should appear, tap "Refresh Now". If a prompt appears asking you if you want to revoke a certificate from AltStore, tap "yes".
+ * If successful, this will open your device to your home screen, accompanied by a notification from SideStore documenting this behavior.
If SideStore is not refreshed, a bug causing early expiry will require you to reinstall SideStore. There is a plan to have this done automatically, but for now it needs to be done manually.
-If you reinstall SideStore or install it on another device under the same Apple ID using AltServer, your certificate will be revoked and you will need to refresh it manually again as shown above (on both devices, if applicable).
+If you reinstall SideStore or install it on another device under the same Apple ID using AltServer, your certificate will be revoked and you will need to refresh it manually again as shown above (on all devices, if applicable).
From 3d4dc54a2c75549b2d6a229d5fed4be05862039e Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:39:07 -0600
Subject: [PATCH 68/78] Update pairing-file.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 21c0275d..35ec4d26 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -4,7 +4,7 @@ description: Pairing files are essential to SideStore's functionality.
sidebar_position: 5
---
-idevice pair allows us to create a pairing file for programs like SideStore to talk to your device remotely. This is required to use SideStore, or it will not function.
+idevice pair is a program which creates a Jitterbug pairing file, allowing programs like SideStore to talk to your device remotely. This is required to use SideStore, otherwise it will not function.
Download idevice pair for:
- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg)
From e2719afc14700b74b100050ebb9d361691fb2dac Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Tue, 27 May 2025 14:41:05 -0600
Subject: [PATCH 69/78] Update linux.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/linux.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index 6de8b93e..3507e045 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -6,14 +6,14 @@ sidebar_position: 4
Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)!
-1. The following will install usbmuxd and docker. Run these as a non-root user and you only have to do this once.
+1. The following commands will install usbmuxd and docker. Run these as a non-root user on your machine and you will only have to do this once.
```bash
sudo apt install -y usbmuxd
curl -fsSL https://test.docker.com -o test-docker.sh
sudo sh test-docker.sh
sudo usermod -aG docker $USER
```
-2. Restart your shell to ensure changes are made. Now, plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. Now, run Altcon with Docker using this code:
+2. Restart your shell to ensure changes are made. Now, plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. Now, run Altcon with Docker using this code (must be run every time to install SideStore):
```bash
docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon
```
From f5d2ac063ec7057566db9b39a1a47ca713806b45 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Wed, 28 May 2025 14:37:30 -0600
Subject: [PATCH 70/78] Update package.json
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
package.json | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/package.json b/package.json
index 8d19f72e..a0703588 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "side-store-docs",
- "version": "0.0.0",
+ "version": "3.8.0",
"private": true,
"scripts": {
"docusaurus": "docusaurus",
@@ -14,8 +14,8 @@
"write-heading-ids": "docusaurus write-heading-ids"
},
"dependencies": {
- "@docusaurus/core": "3.7.0",
- "@docusaurus/preset-classic": "3.7.0",
+ "@docusaurus/core": "3.8.0",
+ "@docusaurus/preset-classic": "3.8.0",
"@mdx-js/react": "^3.0.0",
"clsx": "^2.0.0",
"prism-react-renderer": "^2.3.0",
@@ -23,8 +23,8 @@
"react-dom": "^18.0.0"
},
"devDependencies": {
- "@docusaurus/module-type-aliases": "3.7.0",
- "@docusaurus/types": "3.7.0"
+ "@docusaurus/module-type-aliases": "3.8.0",
+ "@docusaurus/types": "3.8.0"
},
"browserslist": {
"production": [
From 54b08b73087b6596928d098238c3438418a3f30e Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Wed, 28 May 2025 17:07:51 -0600
Subject: [PATCH 71/78] Update package.json
---
package.json | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/package.json b/package.json
index a0703588..8d19f72e 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "side-store-docs",
- "version": "3.8.0",
+ "version": "0.0.0",
"private": true,
"scripts": {
"docusaurus": "docusaurus",
@@ -14,8 +14,8 @@
"write-heading-ids": "docusaurus write-heading-ids"
},
"dependencies": {
- "@docusaurus/core": "3.8.0",
- "@docusaurus/preset-classic": "3.8.0",
+ "@docusaurus/core": "3.7.0",
+ "@docusaurus/preset-classic": "3.7.0",
"@mdx-js/react": "^3.0.0",
"clsx": "^2.0.0",
"prism-react-renderer": "^2.3.0",
@@ -23,8 +23,8 @@
"react-dom": "^18.0.0"
},
"devDependencies": {
- "@docusaurus/module-type-aliases": "3.8.0",
- "@docusaurus/types": "3.8.0"
+ "@docusaurus/module-type-aliases": "3.7.0",
+ "@docusaurus/types": "3.7.0"
},
"browserslist": {
"production": [
From a5ddf37b93fd3b5751f14c6745164ab985725851 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Thu, 29 May 2025 06:30:27 -0600
Subject: [PATCH 72/78] Update troubleshooting.mdx
---
docs/troubleshooting/troubleshooting.mdx | 22 ++++++++++++----------
1 file changed, 12 insertions(+), 10 deletions(-)
diff --git a/docs/troubleshooting/troubleshooting.mdx b/docs/troubleshooting/troubleshooting.mdx
index 0a83d319..91fd0fe8 100644
--- a/docs/troubleshooting/troubleshooting.mdx
+++ b/docs/troubleshooting/troubleshooting.mdx
@@ -5,15 +5,15 @@ description: A guide to troubleshooting SideStore.
## Installation
-#### I followed the instructions, but I still can't install SideStore.
+### I followed the instructions, but I still can't install SideStore.
-### Mac Instructions
+#### Mac Instructions
1. **Trust Device**: After connecting your iOS device to your Mac, ensure you have said “Trust” on both your Mac and iOS device. You can verify this by:
- Opening Finder (macOS 10.15 Catalina or later) or iTunes (macOS 10.14 Mojave and earlier).
- Disconnect and reconnect your phone to your mac and check 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 use for free.
-### Windows Instructions
+#### 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:
- 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.
@@ -27,7 +27,7 @@ description: A guide to troubleshooting SideStore.
## Sign-In Issues
-#### SideStore Freezing or Displaying an Error Code During Sign-In
+### SideStore Freezing or Displaying an Error Code During Sign-In
If you encounter freezing or error codes while attempting to sign in to SideStore, there could be several potential causes. Follow these steps to resolve the issue:
@@ -41,7 +41,7 @@ If you encounter freezing or error codes while attempting to sign in to SideStor
2. **Host Your Own Anisette Server:**
If you prefer, you can set up your own Anisette server. Detailed instructions for hosting an Anisette server are available in the official documentation and can be found [here](https://docs.sidestore.io/docs/advanced/anisette).
-#### Verification Code Not Received When Signing In with Apple ID
+### Verification Code Not Received When Signing In with Apple ID
Another common issue during sign-in is not receiving a verification code when using your Apple ID with SideStore. This can be resolved by following these steps:
@@ -66,7 +66,7 @@ Another common issue during sign-in is not receiving a verification code when us
## Can't Refresh or Install Apps
-#### Resolving No Wi-Fi or VPN Error
+### 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:
@@ -80,7 +80,7 @@ Another common issue during sign-in is not receiving a verification code when us
## Cannot Choose Pairing File
-#### If you are unable to select a pairing file in Sidestore, follow these steps to resolve the issue:
+### 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".
@@ -88,7 +88,7 @@ Another common issue during sign-in is not receiving a verification code when us
## AltJIT
-#### AltServer says “JIT could not be enabled for [App]".
+### 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:
@@ -102,10 +102,12 @@ This could happen for a number of reasons. If you’re experiencing this issue,
- 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 here, you can email [support@altstore.io](mailto:support@altstore.io), and they will try to get back to you as soon as they can.
+If you can't find the answer to your question about AltJIT here, you can email [support@altstore.io](mailto:support@altstore.io), and they will try to get back to you as soon as they can.
:::
-## What if I need to use the Windows Store version of iCloud?
+## AltServer
+
+### What if I need to use the Windows Store version of iCloud?
AltServer requires that you install iCloud directly from Apple in order to authenticate your Apple ID. If you want or need to use the Windows Store version as well, you can follow these alternate instructions copied from [this reddit post](https://www.reddit.com/r/jailbreak/comments/rp5buz/tutorial\_how\_to\_use\_altserver\_if\_you\_have\_to\_use/?utm\_source=share\&utm\_medium=ios\_app\&utm\_name=iossmf) and updated:
From b4588c2e2ec3511ba050a128e83f44c9aa3f7880 Mon Sep 17 00:00:00 2001
From: "Anon Y. Mus" <195480169+CelloSerenity@users.noreply.github.com>
Date: Thu, 29 May 2025 23:19:49 -0600
Subject: [PATCH 73/78] Update faq.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update and rename sparserestore.mdx to 3appbypass.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update sidebars.js
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update faq.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update faq.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update 3appbypass.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update 3appbypass.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update 3appbypass.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update faq.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Update prerequisites.mdx
Update prerequisites.mdx
---
.../{sparserestore.mdx => 3appbypass.mdx} | 37 ++++++++++++++++---
docs/faq.mdx | 24 ++++++------
docs/installation/prerequisites.mdx | 2 +-
sidebars.js | 2 +-
4 files changed, 45 insertions(+), 20 deletions(-)
rename docs/advanced/{sparserestore.mdx => 3appbypass.mdx} (55%)
diff --git a/docs/advanced/sparserestore.mdx b/docs/advanced/3appbypass.mdx
similarity index 55%
rename from docs/advanced/sparserestore.mdx
rename to docs/advanced/3appbypass.mdx
index 5b0a941f..ac60e8e4 100644
--- a/docs/advanced/sparserestore.mdx
+++ b/docs/advanced/3appbypass.mdx
@@ -3,12 +3,10 @@ title: 3-App Limit Bypass
description: A tutorial on how to install more than 3 apps via SideStore using the SparseRestore exploit.
---
+# SparseRestore
:::note
-
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.
@@ -39,5 +37,34 @@ Due to certain limitations, this exploit must be done for every 3 additional app
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 off 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).
+# MacDirtyCow
+:::note
+The MacDirtyCow "Bypass 3 app limit" exploit **only works on iOS/iPadOS versions between 14.0 and 16.1.2**. 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 MacDirtyCow exploit (see note above).
+* At least 1 free app slot.
+* MDC-compatible SideStore build (see below)
+
+## Steps
+
+1. Download the latest verion of SideStore compatible with the MDC exploit [here](https://cdn.discordapp.com/attachments/949183273827983370/1074037820328521829/SideStore_MDC_14.ipa). The MDC version of SideStore above (bypass 3-app limit) is only compatible with iOS 15.0-16.1.2, and is very outdated, and so you may experience issues. If you want to have this feature, we reccomend you join our [Discord](https://discord.gg/RgpFBX3Q3k) and go to the [sidestore-downloads](https://discord.com/channels/949183273383395328/1126118099930861638) channel, which will contain MDC compatible SideStore builds.
+
+2. Download WDBRemoveThreeAppLimit.ipa [from GitHub](https://github.com/zhuowei/WDBRemoveThreeAppLimit/releases/tag/v1.0)
+
+3. Sideload the .ipa with SideStore
+
+4. Open WDBRemoveThreeAppLimit and tap ‘Go’
+
+5. Return to SideStore and open the Settings tab
+
+6. Swipe up with 3 fingers 3 times to reveal MacDirtyCow section
+
+7. Disable “Enforce 3-App Limit”
+
+8. You can now install more than 3 apps! (10 app id limit still applies)
+
+
+# Alternatives
+
+If either of the exploits 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](https://livecontainer.github.io/), 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 than the exploits in some cases. The GitHub page can be found [here](https://github.com/khanhduytran0/LiveContainer).
diff --git a/docs/faq.mdx b/docs/faq.mdx
index c07dec89..43f8955b 100644
--- a/docs/faq.mdx
+++ b/docs/faq.mdx
@@ -40,27 +40,25 @@ 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.
-To remove this restriction (and also get a 365 day expiry), you can pay for a $99/year Apple Developer account.
+To remove this restriction (and also get a 365 day expiry), you can pay for a $99/year Apple Developer account, or find a certificate.
-Alternatively, there is currently a nightly build available [here](https://github.com/SideStore/SideStore/releases/tag/nightly) (version 0.5.9-nightly.2024.10.23.1+1e969a0 as of writing) that utilizes the SparseRestore exploit to bypass the 3-app limit. Currently, this only works on iOS versions below 18 dev beta 5 plus 18.0.1 for definite.
+Alternatively, there are exploits avaliable to [bypass the 3-app limit](advanced/3appbypass), but usually don't work on the latest iOS versions.
-A tutorial for using this can be found [here](advanced/sparserestore).
+### 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).
### 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)!
-### I am a developer, how does this affect me?
+### I am a developer, do I need to do anything to make my app compatible with SideStore?
-It doesn’t affect you directly, other than maybe an update to AltKit when/if we get our additions.
+Nope, for now SideStore signs just the same way as AltStore, and is fully compatible. In the future, an update to AltKit may be required if/when we get our additions.
### Do I need to install AltStore to install SideStore?
@@ -82,7 +80,7 @@ This was a test update to see if there were problems between major versions, and
### Why do my JIT based apps not automatically activate JIT?
-We currently don’t have an automatic JIT activation method, and if we do you would need the SideStore VPN on.
+We currently don’t have an automatic JIT activation method.
### Does SideStore have an iPadOS UI?
@@ -100,7 +98,7 @@ Older Anisette servers that are used by many users are known to cause locking of
This is a login issue with the Anisette server. There isn’t really much of any info about it other than changing Anisette servers sometimes helps, or you can keep trying to login until it does.
-### Can I transfer my AltStore/Sideloady apps?
+### Can I transfer my AltStore/Sideloadly apps?
Yes, just don’t remove the original app on your device. Go into SideStore and sideload the same or updated IPA, and it should be added to your list of apps within SideStore with your data still intact.
@@ -122,11 +120,11 @@ Don't panic! Re-sideload the apps without removing them from your device, and yo
### I'm unable to select my pairing file with any file type
-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. Also, when signing Sidestore with a certificate, you won't be able to select the pairing file from within app. You can try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad", and naming it `ALTPairingFile.mobiledevicepairing`. 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 name mentioned above. Note that it is case sensitive.
+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. Also, when signing SideStore with a certificate, you won't be able to select the pairing file from within app. You can try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad", and naming it `ALTPairingFile.mobiledevicepairing`. 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 name mentioned above. Note that it is case sensitive.
### Cannot start DebugServer
-There is times when the Debugserver doesn't work. However, there is a fix you can try.
+There is times when the DebugServer doesn't work. However, there is a fix you can try:
**Make a new pairing file**
diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx
index 64af168c..46ee3c47 100644
--- a/docs/installation/prerequisites.mdx
+++ b/docs/installation/prerequisites.mdx
@@ -15,7 +15,7 @@ To install SideStore, you will need:
- An Apple ID
- The StosVPN app (see below)
- A Wi-Fi connection
-- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/troubleshooting/))
+- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/troubleshooting))
## StosVPN
diff --git a/sidebars.js b/sidebars.js
index 87772bde..72be89c7 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -34,7 +34,7 @@ const sidebars = {
{
type: 'category',
label: 'Advanced',
- items: ['advanced/anisette', 'advanced/app-sources', 'advanced/url-schema', 'advanced/sparserestore', 'advanced/jit'],
+ items: ['advanced/anisette', 'advanced/app-sources', 'advanced/url-schema', 'advanced/3appbypass', 'advanced/jit'],
},
'release-notes',
],
From e6622174b9df10fe4fcd5eebe28acb9b5b394de4 Mon Sep 17 00:00:00 2001
From: "Anon Y. Mus" <195480169+CelloSerenity@users.noreply.github.com>
Date: Thu, 29 May 2025 23:20:42 -0600
Subject: [PATCH 74/78] Revert "Update faq.mdx"
This reverts commit b4588c2e2ec3511ba050a128e83f44c9aa3f7880.
---
.../{3appbypass.mdx => sparserestore.mdx} | 37 +++----------------
docs/faq.mdx | 24 ++++++------
docs/installation/prerequisites.mdx | 2 +-
sidebars.js | 2 +-
4 files changed, 20 insertions(+), 45 deletions(-)
rename docs/advanced/{3appbypass.mdx => sparserestore.mdx} (55%)
diff --git a/docs/advanced/3appbypass.mdx b/docs/advanced/sparserestore.mdx
similarity index 55%
rename from docs/advanced/3appbypass.mdx
rename to docs/advanced/sparserestore.mdx
index ac60e8e4..5b0a941f 100644
--- a/docs/advanced/3appbypass.mdx
+++ b/docs/advanced/sparserestore.mdx
@@ -3,10 +3,12 @@ title: 3-App Limit Bypass
description: A tutorial on how to install more than 3 apps via SideStore using the SparseRestore exploit.
---
-# SparseRestore
:::note
+
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.
@@ -37,34 +39,5 @@ Due to certain limitations, this exploit must be done for every 3 additional app
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 off again.
-# MacDirtyCow
-:::note
-The MacDirtyCow "Bypass 3 app limit" exploit **only works on iOS/iPadOS versions between 14.0 and 16.1.2**. 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 MacDirtyCow exploit (see note above).
-* At least 1 free app slot.
-* MDC-compatible SideStore build (see below)
-
-## Steps
-
-1. Download the latest verion of SideStore compatible with the MDC exploit [here](https://cdn.discordapp.com/attachments/949183273827983370/1074037820328521829/SideStore_MDC_14.ipa). The MDC version of SideStore above (bypass 3-app limit) is only compatible with iOS 15.0-16.1.2, and is very outdated, and so you may experience issues. If you want to have this feature, we reccomend you join our [Discord](https://discord.gg/RgpFBX3Q3k) and go to the [sidestore-downloads](https://discord.com/channels/949183273383395328/1126118099930861638) channel, which will contain MDC compatible SideStore builds.
-
-2. Download WDBRemoveThreeAppLimit.ipa [from GitHub](https://github.com/zhuowei/WDBRemoveThreeAppLimit/releases/tag/v1.0)
-
-3. Sideload the .ipa with SideStore
-
-4. Open WDBRemoveThreeAppLimit and tap ‘Go’
-
-5. Return to SideStore and open the Settings tab
-
-6. Swipe up with 3 fingers 3 times to reveal MacDirtyCow section
-
-7. Disable “Enforce 3-App Limit”
-
-8. You can now install more than 3 apps! (10 app id limit still applies)
-
-
-# Alternatives
-
-If either of the exploits 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](https://livecontainer.github.io/), 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 than the exploits in some cases. The GitHub page can be found [here](https://github.com/khanhduytran0/LiveContainer).
+## 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).
diff --git a/docs/faq.mdx b/docs/faq.mdx
index 43f8955b..c07dec89 100644
--- a/docs/faq.mdx
+++ b/docs/faq.mdx
@@ -40,25 +40,27 @@ 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.
-To remove this restriction (and also get a 365 day expiry), you can pay for a $99/year Apple Developer account, or find a certificate.
+To remove this restriction (and also get a 365 day expiry), you can pay for a $99/year Apple Developer account.
-Alternatively, there are exploits avaliable to [bypass the 3-app limit](advanced/3appbypass), but usually don't work on the latest iOS versions.
+Alternatively, there is currently a nightly build available [here](https://github.com/SideStore/SideStore/releases/tag/nightly) (version 0.5.9-nightly.2024.10.23.1+1e969a0 as of writing) that utilizes the SparseRestore exploit to bypass the 3-app limit. Currently, this only works on iOS versions below 18 dev beta 5 plus 18.0.1 for definite.
-### 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).
+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)!
-### I am a developer, do I need to do anything to make my app compatible with SideStore?
+### I am a developer, how does this affect me?
-Nope, for now SideStore signs just the same way as AltStore, and is fully compatible. In the future, an update to AltKit may be required if/when we get our additions.
+It doesn’t affect you directly, other than maybe an update to AltKit when/if we get our additions.
### Do I need to install AltStore to install SideStore?
@@ -80,7 +82,7 @@ This was a test update to see if there were problems between major versions, and
### Why do my JIT based apps not automatically activate JIT?
-We currently don’t have an automatic JIT activation method.
+We currently don’t have an automatic JIT activation method, and if we do you would need the SideStore VPN on.
### Does SideStore have an iPadOS UI?
@@ -98,7 +100,7 @@ Older Anisette servers that are used by many users are known to cause locking of
This is a login issue with the Anisette server. There isn’t really much of any info about it other than changing Anisette servers sometimes helps, or you can keep trying to login until it does.
-### Can I transfer my AltStore/Sideloadly apps?
+### Can I transfer my AltStore/Sideloady apps?
Yes, just don’t remove the original app on your device. Go into SideStore and sideload the same or updated IPA, and it should be added to your list of apps within SideStore with your data still intact.
@@ -120,11 +122,11 @@ Don't panic! Re-sideload the apps without removing them from your device, and yo
### I'm unable to select my pairing file with any file type
-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. Also, when signing SideStore with a certificate, you won't be able to select the pairing file from within app. You can try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad", and naming it `ALTPairingFile.mobiledevicepairing`. 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 name mentioned above. Note that it is case sensitive.
+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. Also, when signing Sidestore with a certificate, you won't be able to select the pairing file from within app. You can try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad", and naming it `ALTPairingFile.mobiledevicepairing`. 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 name mentioned above. Note that it is case sensitive.
### Cannot start DebugServer
-There is times when the DebugServer doesn't work. However, there is a fix you can try:
+There is times when the Debugserver doesn't work. However, there is a fix you can try.
**Make a new pairing file**
diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx
index 46ee3c47..64af168c 100644
--- a/docs/installation/prerequisites.mdx
+++ b/docs/installation/prerequisites.mdx
@@ -15,7 +15,7 @@ To install SideStore, you will need:
- An Apple ID
- The StosVPN app (see below)
- A Wi-Fi connection
-- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/troubleshooting))
+- Some time (This is a quick process, but you should [leave time for troubleshooting](/docs/troubleshooting/))
## StosVPN
diff --git a/sidebars.js b/sidebars.js
index 72be89c7..87772bde 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -34,7 +34,7 @@ const sidebars = {
{
type: 'category',
label: 'Advanced',
- items: ['advanced/anisette', 'advanced/app-sources', 'advanced/url-schema', 'advanced/3appbypass', 'advanced/jit'],
+ items: ['advanced/anisette', 'advanced/app-sources', 'advanced/url-schema', 'advanced/sparserestore', 'advanced/jit'],
},
'release-notes',
],
From e752f698075eb30af7067b1130dc2daac775889d Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 31 May 2025 15:16:40 -0600
Subject: [PATCH 75/78] Update sparserestore.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/advanced/sparserestore.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/advanced/sparserestore.mdx b/docs/advanced/sparserestore.mdx
index 5b0a941f..df370a4d 100644
--- a/docs/advanced/sparserestore.mdx
+++ b/docs/advanced/sparserestore.mdx
@@ -40,4 +40,4 @@ Due to certain limitations, this exploit must be done for every 3 additional app
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 off 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).
+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](https://livecontainer.github.io/), 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).
From 7b1bcb542830a9e3634344b3a64bd9918b889994 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Sat, 31 May 2025 16:06:49 -0600
Subject: [PATCH 76/78] Update common-issues.mdx
---
docs/troubleshooting/common-issues.mdx | 16 +++++++---------
1 file changed, 7 insertions(+), 9 deletions(-)
diff --git a/docs/troubleshooting/common-issues.mdx b/docs/troubleshooting/common-issues.mdx
index c95f228e..8348ca7d 100644
--- a/docs/troubleshooting/common-issues.mdx
+++ b/docs/troubleshooting/common-issues.mdx
@@ -23,7 +23,7 @@ Connection issues or an invalid pairing file.
Connection issues with the minimuxer service.
#### Resolution
1. If using WireGuard, switch to StosVPN
-2. Try again (spamming the button usually helps)
+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.
@@ -35,12 +35,10 @@ Cache issues.
1. Restart SideStore
2. Clear Cache
3. Change Anisette Server
-4. Reset adi.pb
-5. Sign out from SideStore and sign back in
-6. Use WireGuard
-7. Restart device
-8. Regenerate pairing file
-9. Reinstall SideStore
+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
### Unable to Launch SideStore
#### Cause
@@ -54,8 +52,8 @@ 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.
+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.
From 94e2d13887b4eb80092fa608113244712bcc51ec Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Thu, 5 Jun 2025 13:29:58 -0600
Subject: [PATCH 77/78] Update pairing-file.mdx
Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
---
docs/installation/pairing-file.mdx | 3 +++
1 file changed, 3 insertions(+)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 35ec4d26..279bdefc 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -5,6 +5,9 @@ sidebar_position: 5
---
idevice pair is a program which creates a Jitterbug pairing file, allowing programs like SideStore to talk to your device remotely. This is required to use SideStore, otherwise it will not function.
+:::warning
+Caution, if you update or reset your iDevice, your pairing file will expire and you will need to generate a new one. This also occurs at random times, and there is nothing we can do at this point to fix it.
+:::
Download idevice pair for:
- [macOS](https://github.com/jkcoxson/idevice_pair/releases/latest/download/iDevicePair--macos-universal.dmg)
From d0fff18a34d61c05b3e09caf63a858064f4f8b16 Mon Sep 17 00:00:00 2001
From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com>
Date: Thu, 5 Jun 2025 13:38:47 -0600
Subject: [PATCH 78/78] Update pairing-file.mdx
---
docs/installation/pairing-file.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx
index 279bdefc..0acdd04d 100644
--- a/docs/installation/pairing-file.mdx
+++ b/docs/installation/pairing-file.mdx
@@ -36,7 +36,7 @@ Download idevice pair for:
### Linux
1. If not already installed for Altcon, in the linux commandline, run the following code to install usbmuxd:
-```
+```bash
sudo apt install -y usbmuxd
```
2. Download the version of idevice pair that corresponds to your PC's architecture and make it executable.