From c464ccbc1a28cbccc96504f0d17f6eadb6dd823d Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Thu, 12 Jun 2025 14:01:04 -0600 Subject: [PATCH 01/18] 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 fd257110..3f012a93 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, 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). +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 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). From 1a9bf7b8bf516ca9ab0b4e6d1dd4e43bd4b47caa Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sat, 14 Jun 2025 22:21:24 -0600 Subject: [PATCH 02/18] Update anisette.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/advanced/anisette.mdx | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/docs/advanced/anisette.mdx b/docs/advanced/anisette.mdx index cb7fa5e2..469715fb 100644 --- a/docs/advanced/anisette.mdx +++ b/docs/advanced/anisette.mdx @@ -11,13 +11,13 @@ With this, it is **highly recommended** to use a v3 server for normal use of Sid Anisette data is information used in the app signing process that needs to be generated each time you install or refresh apps. SideStore gets this information from a server that spoofs a Mac and sends you back the anisette data. No account info is sent to the server ever in this process. -When many people use the same Anisette server (specifically a v1 server), it trips Apple's security, and locks the accounts that were using that machine. This is why we recommend using a separate burner Apple ID instead of your main one. +When many people use the same Anisette server (specifically a v1 server), it trips Apple's security, and locks the accounts that were using that machine. This is why we recommended using a separate burner Apple ID instead of your main one. Our team has worked on better approaches to avoid locked accounts (in the form of _anisette-v3_). However, if you are using an older version of SideStore, hosting your own anisette server is a great way to avoid locked accounts. This is made incredibly easy thanks to our current server being open source and made for docker environments. This means we can deploy a server with nothing more than the GitHub link. ## Deploy on Render -[Render](https://render.com/) is a service for easily creating servers. It supports loading server sources from GitHub. The free tier is quite limited in terms of resources, but the server can run comfortably on it without issue. +[Render](https://render.com/) is a service for easily creating servers. It supports loading server sources from GitHub. The free tier is quite limited in terms of resources, but the server can run comfortably on it without issue. (FYI-It does require a credit/debit card for identification, but is completely free) Due to too many people using the same GitHub URL, you will have to fork the Git repository yourself. @@ -80,7 +80,7 @@ If you want to keep the option of using included servers, follow the steps below ``` * Commit the changes, then head to https://[your GitHub username].github.io/[where you placed the file]/servers.json. If the file loads, you are ready to move on to the next section. Otherwise, you may need to wait up to 10 mins for your site to be properly set up for use before you try again. -If you want to only use your own server, follow the steps above, but instead of getting the official server.json, create your own using this formatting; +If you want to only use your own server, follow the steps above, but instead of copying the official servers.json, create your own using this formatting; ``` { "servers": [ @@ -105,11 +105,3 @@ To use your newly created server list in the SideStore app, do the following: ## Done! SideStore will now use your new custom anisette server. - - -## Links: -[](https://uptime.sidestore.io/status/all) -[All Official Anisette Servers Uptime](https://uptime.sidestore.io/status/all) - -[](https://uptime.sidestore.io/status/ss) -[Our Official Anisette Server's Uptime](https://uptime.sidestore.io/status/ss) From 9a6849a4d57ef6edb94936cc5e17aa2bd5f2aa9c Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Mon, 23 Jun 2025 21:11:24 -0600 Subject: [PATCH 03/18] Update docusaurus.config.js Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 1eb5e2a2..14cb82a2 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -99,7 +99,7 @@ const config = { position: 'right', }, { - href: 'https://discord.gg/sidestore', + href: 'https://discord.gg/sidestore-949183273383395328', label: 'Discord', position: 'right', }, From f6ce00e6b00ca3675cf9062e01dfaf51977b2b23 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Mon, 23 Jun 2025 21:11:58 -0600 Subject: [PATCH 04/18] Update TRANSLATION_GUIDE.md Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- i18n/TRANSLATION_GUIDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/TRANSLATION_GUIDE.md b/i18n/TRANSLATION_GUIDE.md index 56de4122..cd2c5adb 100644 --- a/i18n/TRANSLATION_GUIDE.md +++ b/i18n/TRANSLATION_GUIDE.md @@ -98,4 +98,4 @@ Once you've completed translating a document: ## Need Help? -If you have any questions about the translation process or need clarification on technical terms, ping us in our discord server and we'll help you out as soon as possible. \ No newline at end of file +If you have any questions about the translation process or need clarification on technical terms, ping us in our [discord server](https://discord.gg/sidestore-949183273383395328) and we'll help you out as soon as possible. From 7de37f94c273e0a8f5e8d9bf074567cd9967b765 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Mon, 23 Jun 2025 21:12:11 -0600 Subject: [PATCH 05/18] Update common-issues.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/troubleshooting/common-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/troubleshooting/common-issues.mdx b/docs/troubleshooting/common-issues.mdx index 8348ca7d..6b5e1529 100644 --- a/docs/troubleshooting/common-issues.mdx +++ b/docs/troubleshooting/common-issues.mdx @@ -5,7 +5,7 @@ description: Common issues found in SideStore. :::warning -This page is currently a work in progress. The information provided should be accurate, but please refer to our [Discord server](https://discord.com/invite/sidestore) for assistance if needed. +This page is currently a work in progress. The information provided should be accurate, but please refer to our [Discord server](https://discord.gg/sidestore-949183273383395328) for assistance if needed. ::: From fee580936b2cf380e6b86ab3c5e2e072163af15a Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Mon, 23 Jun 2025 21:12:37 -0600 Subject: [PATCH 06/18] Update error-codes.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/troubleshooting/error-codes.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/troubleshooting/error-codes.mdx b/docs/troubleshooting/error-codes.mdx index fd42ba5e..b6c68ad2 100644 --- a/docs/troubleshooting/error-codes.mdx +++ b/docs/troubleshooting/error-codes.mdx @@ -5,7 +5,7 @@ description: Error codes found in SideStore. :::warning -This page is currently not fully accurate to how SideStore works, as this is based on AltStore's Error Codes page. Some info is still correct, but please don't rely on this word for word. Make sure to ask in our [Discord server](https://discord.com/invite/sidestore) for help if you need it. +This page is currently not fully accurate to how SideStore works, as this is based on AltStore's Error Codes page. Some info is still correct, but please don't rely on this word for word. Make sure to ask in our [Discord server](https://discord.gg/sidestore-949183273383395328) for help if you need it. ::: @@ -468,4 +468,4 @@ This means that an error occurred while writing files to disk. Make sure your ph `AltServer.ProcessError` -If you are trying to enable JIT on an iOS 17 device, you may see this error. Make sure to install all dependencies and keep your device connected with the app open until JIT has successfully been enabled. \ No newline at end of file +If you are trying to enable JIT on an iOS 17 device, you may see this error. Make sure to install all dependencies and keep your device connected with the app open until JIT has successfully been enabled. From 90cf9d463d4688fcbb3802346dea441ef61cd6f2 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Mon, 23 Jun 2025 21:54:46 -0600 Subject: [PATCH 07/18] Update error-codes.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/troubleshooting/error-codes.mdx | 66 ++++++++++++++++++++-------- 1 file changed, 48 insertions(+), 18 deletions(-) diff --git a/docs/troubleshooting/error-codes.mdx b/docs/troubleshooting/error-codes.mdx index b6c68ad2..8681cb30 100644 --- a/docs/troubleshooting/error-codes.mdx +++ b/docs/troubleshooting/error-codes.mdx @@ -13,77 +13,79 @@ This page is currently not fully accurate to how SideStore works, as this is bas #### (1000) An unknown error occurred. -`AltStore.OperationError` +`SideStore.OperationError 1000` This means that SideStore ran into an unexpected error. Please check our [Troubleshooting Guide](./), and you can reach out to us directly if the issue persists. #### (1001) The operation returned an unknown result. +`SideStore.OperationError 1001` + This means that SideStore ran into an unexpected error. Please check our [Troubleshooting Guide](./), and you can reach out to us directly if the issue persists. #### (1002) The operation was cancelled. -`AltStore.OperationError` +`SideStore.OperationError 1002` This means that the performed action was stopped. Please try again. #### (1003) The operation timed out. -`AltStore.OperationError` +`SideStore.OperationError 1003` This means that SideStore ran into problems trying to complete the requested action. Please try again and check our [Troubleshooting Guide](./) for additional help. You can reach out to us directly if the issue persists. #### (1004) You are not signed in. -`AltStore.OperationError` +`SideStore.OperationError 1004` This means that you must enter your Apple ID information in the settings tab to do the requested action. #### (1005) The app could not be found. -`AltStore.OperationError` +`SideStore.OperationError 1005` -This means that AltStore could not locate the file to download or install, most likely because the file does not exist at the provided URL. +This means that SideStore could not locate the file to download or install, most likely because the file does not exist at the provided URL. #### (1006) AltStore could not determine this device's UDID. -`AltStore.OperationError` +`SideStore.OperationError 1006` This means that SideStore couldn't read the device UDID embedded by AltServer when installing SideStore. Make sure you're installing SideStore with the latest AltServer version and not via another method. #### (1007) This app is in an invalid format. -`AltStore.OperationError` +`SideStore.OperationError 1007` This means the app you're trying to install is not a standard .ipa. Try downloading the app from another location. #### (1008) Invalid parameters. -`AltStore.OperationError` +`SideStore.OperationError 1008` -This means an internal error occured and SideStore couldn't provide the necessary information to perform the requested task. Please try again and check our [Troubleshooting Guide](./) for additional help. You can reach out to us directly if the issue persists. +This means an internal error occured and SideStore couldn't provide the necessary information to perform the requested task. Please try again and check our [Troubleshooting Guide](./) for additional help. You can reach out to us directly if the issue persists at our Discord server. #### (1009) You cannot register more than 10 App IDs within a 7-day period. -`AltStore.OperationError` +`SideStore.OperationError 1009` -This means that you have reached the maximum amount of App IDs available. Please check the App IDs in the My Apps tab to see when they will expire. +This means that you have reached the maximum amount of App IDs available. Apps IDs are not able to be deleted manually. App IDs renew if the app has exists 7 days after when it was first installed or renewed last, and expire if they have been deleted since. Please check the App IDs in the My Apps tab to see when they will expire. #### (1010) There are no AltStore sources. -`AltStore.OperationError` +`SideStore.OperationError 1010` -This means an internal error occured and SideStore is unable to fetch changes for any Sources you've added. Please try again and check our [Troubleshooting Guide](./) for additional help. You can reach out to us directly if the issue persists. +This means an internal error occured and SideStore is unable to fetch changes for any AltSources you've added. Please try again and check our [Troubleshooting Guide](./) for additional help. You can reach out to us directly at our Discord server if the issue persists. #### (1011) AltStore was denied permission to launch the app. -`AltStore.OperationError` +`SideStore.OperationError 1011` -This means SideStore couldn't launch a sideloaded app because you tapped "Cancel" on the "AltStore wants to open \[app]" alert, or because you still need to trust your Apple ID in Settings. +This means SideStore couldn't launch a sideloaded app because you tapped "Cancel" on the "SideStore wants to open \[app]" alert, or because you still need to trust your Apple ID in Settings. #### (1012) AltStore's shared app group could not be accessed. -`AltStore.OperationError` +`SideStore.OperationError 1012` This means SideStore was not able to access the directory where app backups are stored. Make sure you're installing SideStore with the latest AltServer version and not via another method. @@ -91,7 +93,7 @@ This means SideStore was not able to access the directory where app backups are `AltStore.OperationError` -This means that SideStore is having trouble discovering AltServer on your local network. Make sure you're connected to the same Wi-Fi network as your PC/Mac running AltServer, or try connecting your device to your computer via USB. +This means that SideStore is having trouble discovering AltServer on your local network. Make sure you're connected to the same Wi-Fi network as your PC/Mac running AltServer, or try connecting your device to your computer via USB. (You shouldn't recieve this error as SideStore functions differently that AltStore) #### (1201) A connection to AltServer could not be established. @@ -105,6 +107,34 @@ This means that SideStore is having trouble connecting to AltServer on your PC/M This means that SideStore's connection to AltServer on your PC/Mac was interrupted. Make sure you have Wi-Fi sync enabled, and otherwise you may try plugging in your device directly via USB. +#### (1403) Unable to connect to SideJITServer. + +`SideStore.OperationError 1403` + +Please make sure you are on the same Wi-Fi as your computer running SideJITServer and that your Firewall has been set appropriately. + +#### (1412) Unable to connect to a V3 anisette server. + +`SideStore.OperationError 1412` + +Your device was unable to recieve data from a V3 anisette server. Please try again, or switch anisette servers. + +#### (1414) No Wi-Fi/StosVPN. + +`SideStore.OperationError 1414` + +You do not appear to be connected to Wi-Fi and/or StosVPN. SideStore cannot refresh or install applications without Wi-Fi and StosVPN, ensure both are enabled. If that doesn't work, try regenerating your pairing file. + +## Minimuxer Errors + +#### (27) AFC was unable to manage files on the device. + +`minimuxer.MinimuxerError 27` + +This means you have an invalid pairing file. Follow the steps to regenerate. + +More error codes coming... + ## AltServer / SideServer Errors #### (0) Exception Error From e6df307f066934e60e0220d213c93d79c2114428 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sat, 28 Jun 2025 20:39:09 -0600 Subject: [PATCH 08/18] Update linux.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/installation/linux.mdx | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx index 3507e045..2c416872 100644 --- a/docs/installation/linux.mdx +++ b/docs/installation/linux.mdx @@ -6,14 +6,15 @@ sidebar_position: 4 Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)! -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. +1. Make sure you have usbmuxd and either Docker or Podman installed on your machine. +2. Plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. + +3. Now, run Altcon with Docker or Podman using the following commands: +Docker: ```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 +docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon ``` -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): +Podman: ```bash docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon ``` From 5ad4d7eae0c2708f1ba0b1bcf1ac3df39efc1d29 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sat, 28 Jun 2025 20:40:11 -0600 Subject: [PATCH 09/18] Update pairing-file.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/installation/pairing-file.mdx | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx index 0acdd04d..3cb0cd69 100644 --- a/docs/installation/pairing-file.mdx +++ b/docs/installation/pairing-file.mdx @@ -35,10 +35,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 -``` +1. Ensure usbmuxd is installed on your machine. 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. From 2fba0ded8623308853c90f9c0f266a0d94cdeca1 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sat, 28 Jun 2025 20:40:35 -0600 Subject: [PATCH 10/18] Update linux.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/installation/linux.mdx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx index 2c416872..db3abccb 100644 --- a/docs/installation/linux.mdx +++ b/docs/installation/linux.mdx @@ -10,11 +10,12 @@ Before you start, make sure to have all steps completed found in the [prerequisi 2. Plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. 3. Now, run Altcon with Docker or Podman using the following commands: -Docker: + +Docker setup: ```bash docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon ``` -Podman: +Podman setup: ```bash docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon ``` From 038cbb9356f4409beee2457a7c30a87a889ae547 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sat, 28 Jun 2025 20:41:41 -0600 Subject: [PATCH 11/18] 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 db3abccb..b307a9fb 100644 --- a/docs/installation/linux.mdx +++ b/docs/installation/linux.mdx @@ -9,7 +9,7 @@ Before you start, make sure to have all steps completed found in the [prerequisi 1. Make sure you have usbmuxd and either Docker or Podman installed on your machine. 2. Plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode. -3. Now, run Altcon with Docker or Podman using the following commands: +3. Now, run Altcon with Docker or Podman using the following commands (may require `sudo`): Docker setup: ```bash @@ -17,7 +17,7 @@ docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.i ``` Podman setup: ```bash -docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon +podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon ``` 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: From f21f5d3b3d66275de280c4c2a0af1cbb670be7d9 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sun, 29 Jun 2025 16:20:47 -0600 Subject: [PATCH 12/18] Update error-codes.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/troubleshooting/error-codes.mdx | 26 ++++---------------------- 1 file changed, 4 insertions(+), 22 deletions(-) diff --git a/docs/troubleshooting/error-codes.mdx b/docs/troubleshooting/error-codes.mdx index 8681cb30..ef24804b 100644 --- a/docs/troubleshooting/error-codes.mdx +++ b/docs/troubleshooting/error-codes.mdx @@ -47,7 +47,7 @@ This means that you must enter your Apple ID information in the settings tab to This means that SideStore could not locate the file to download or install, most likely because the file does not exist at the provided URL. -#### (1006) AltStore could not determine this device's UDID. +#### (1006) SideStore could not determine this device's UDID. `SideStore.OperationError 1006` @@ -77,36 +77,18 @@ This means that you have reached the maximum amount of App IDs available. Apps I This means an internal error occured and SideStore is unable to fetch changes for any AltSources you've added. Please try again and check our [Troubleshooting Guide](./) for additional help. You can reach out to us directly at our Discord server if the issue persists. -#### (1011) AltStore was denied permission to launch the app. +#### (1011) SideStore was denied permission to launch the app. `SideStore.OperationError 1011` This means SideStore couldn't launch a sideloaded app because you tapped "Cancel" on the "SideStore wants to open \[app]" alert, or because you still need to trust your Apple ID in Settings. -#### (1012) AltStore's shared app group could not be accessed. +#### (1012) SideStore's shared app group could not be accessed. `SideStore.OperationError 1012` This means SideStore was not able to access the directory where app backups are stored. Make sure you're installing SideStore with the latest AltServer version and not via another method. -#### (1200) AltServer could not be found. - -`AltStore.OperationError` - -This means that SideStore is having trouble discovering AltServer on your local network. Make sure you're connected to the same Wi-Fi network as your PC/Mac running AltServer, or try connecting your device to your computer via USB. (You shouldn't recieve this error as SideStore functions differently that AltStore) - -#### (1201) A connection to AltServer could not be established. - -`AltStore.OperationError` - -This means that SideStore is having trouble connecting to AltServer on your PC/Mac. Make sure you have Wi-Fi sync enabled, and otherwise you may try plugging in your device directly via USB. - -#### (1202) The connection to AltServer was dropped. - -`AltStore.OperationError` - -This means that SideStore's connection to AltServer on your PC/Mac was interrupted. Make sure you have Wi-Fi sync enabled, and otherwise you may try plugging in your device directly via USB. - #### (1403) Unable to connect to SideJITServer. `SideStore.OperationError 1403` @@ -133,7 +115,7 @@ You do not appear to be connected to Wi-Fi and/or StosVPN. SideStore cannot refr This means you have an invalid pairing file. Follow the steps to regenerate. -More error codes coming... +More coming, open to contributions... ## AltServer / SideServer Errors From 864c6598593a4b6e9bfe85b0cba3befbc668c660 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sun, 29 Jun 2025 16:40:24 -0600 Subject: [PATCH 13/18] Update post-install.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/installation/post-install.mdx | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/installation/post-install.mdx b/docs/installation/post-install.mdx index eea42b45..4baf9986 100644 --- a/docs/installation/post-install.mdx +++ b/docs/installation/post-install.mdx @@ -9,12 +9,17 @@ To do this, you need to: 1. Connect to StosVPN. 2. Open SideStore. -3. If you haven't already, select your pairing file. +3. If you haven't already, import/select your pairing file. 4. Sign in with your Apple ID. 5. Navigate to "My Apps". -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. +6. Tap the "x DAYS" button to the right of SideStore, (x is the number of days until an app's expiry). +7. A prompt asking to create a new signing certificate should appear, tap "Refresh Now". +8. If a prompt appears asking if you want to revoke a certificate from AltStore, tap "Yes". -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 this process is successful, SideStore will open your device to your home screen, accompanied by a notification. -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). +If SideStore is not refreshed like this immediately, a bug causing early expiry will require you to reinstall SideStore using AltServer. There is a plan to have this done automatically, but for now it needs to be done manually. + +If you reinstall SideStore using AltServer, your certificate will be revoked and you will need to manually refresh it again. + +If you wish to install SideStore on another device using the same Apple ID, follow [these steps](https://github.com/SideStore/SideStore/pull/1008#issue-3138680291). From 6db0eeaef217bccb861fd69fd400ee0066079d5f Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Sun, 29 Jun 2025 16:53:43 -0600 Subject: [PATCH 14/18] Update faq.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/faq.mdx | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/faq.mdx b/docs/faq.mdx index c07dec89..3e00f7a7 100644 --- a/docs/faq.mdx +++ b/docs/faq.mdx @@ -10,7 +10,9 @@ This is a list of frequently asked questions for SideStore. This has a list of c ## What is SideStore? -SideStore is an iOS application that allows you to sideload apps onto your iOS device using only your Apple ID. SideStore resigns apps with your personal development certificate, and then uses a specially designed VPN in order to trick iOS into installing them. SideStore will periodically "refresh" your apps in the background, to keep their normal 7-day development period from expiring. SideStore's goal is to provide an untethered sideloading experience. It's a community driven fork of AltStore, and has already implemented some of the community's most-requested features. You only need a computer once during installation. +SideStore is an iOS application that allows you to sideload apps onto your iOS device using only your Apple ID. SideStore resigns apps with your personal development certificate, and then uses a [specially designed VPN](https://github.com/jkcoxson/em_proxy) in order to trick iOS into installing them. SideStore will periodically "refresh" your apps in the background, to keep their normal 7-day development period from expiring. + +SideStore's goal is to provide an untethered sideloading experience. It's a community driven fork of [AltStore](https://github.com/rileytestut/AltStore), and has already implemented some of the community's most-requested features. You only need a computer once during installation. (Contributions are welcome! 🙂) @@ -28,9 +30,9 @@ SideStore currently does not have a release date, but is in a public beta state. Yes you can, just like AltStore! -### Does this have AltStore beta features? +### Does SideStore have AltStore (beta) features? -We do have AltStore beta features, but it isn't always latest. We try to keep up to date, or implement them in our own way if it's necessary. +We do implement AltStore (beta) features, but they aren't always latest. We try to keep up to date, or implement them in our own way if it's necessary. ### Will having the VPN on drain my battery? @@ -82,7 +84,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, and if we did you would need StosVPN on. ### Does SideStore have an iPadOS UI? @@ -100,17 +102,17 @@ 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. +Yes, just don’t remove the original app on your device. Go into SideStore and sideload the same or an updated IPA of the app, and it should be added to your list of apps within SideStore with your data still intact. ### Why do I need to refresh SideStore first thing after login? This is because AltServer or other programs sideload SideStore with their own app groupID, while we use our own. Refreshing SideStore changes it to ours, which makes apps disappear as their groupIDs are not updated. It’s best to not sideload anything before refreshing SideStore on a clean install. -### Can I do OTA updates? +### Does SideStore support OTA updates? -Yep! Just click the update button! +Yep! Just click the update button when it appears! ### I want to test a SideStore version, and I want my data to stay when switching to a test version. Do I remove my app or sideload the test version via SideStore? @@ -126,7 +128,7 @@ Make sure your pairing file's extension ends with `.mobiledevicepairing` or `.pl ### 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** From 07294b347481db808a5d029d4cd9b957e5934bb3 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Tue, 1 Jul 2025 10:37:52 -0600 Subject: [PATCH 15/18] Update release-notes.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/release-notes.mdx | 42 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) diff --git a/docs/release-notes.mdx b/docs/release-notes.mdx index c03f67a1..2cf60374 100644 --- a/docs/release-notes.mdx +++ b/docs/release-notes.mdx @@ -6,6 +6,46 @@ sidebar_position: 6 # Stable Notes +## 0.6.2 + +### Changelog +- Deprecation of WireGuard, complete transition to [StosVPN](https://apps.apple.com/us/app/stosvpn/id6744003051) +- jitterbugpair is being superseded by [idevice pair](https://github.com/jkcoxson/idevice_pair) +- Merge more of AltStore 2.0 upstream +- Added support for importing/exporting your Apple ID's certificate for use with multiple devices, instructions to utilize this [here](https://github.com/SideStore/SideStore/pull/1008#issue-3138680291) +- Adds url scheme/allow exporting certificate (to LiveContainer) +- Fix issue where installing apps would get stuck around 75% +- Add option to resuse the main App ID profile for extensions instead of removing/registering them (only one app id/app) +- General type fixes and visual updates + +### What's Changed: +- Rebase 2.0 wip by @nythepegasus in [#794](https://github.com/SideStore/SideStore/pull/794) +- [Refresh]: Remove install stuffs from refresh since in refresh should only renew provisioning profiles by @mahee96 in [#846](https://github.com/SideStore/SideStore/pull/846) +- [Settings]: Fix: DisableAppLimit switch reverting back to off state even if on iOS where sparseRestore is not patched yet by @mahee96 in [#850](https://github.com/SideStore/SideStore/pull/850) +- Update trustedapps.json by @neoarz in [#853](https://github.com/SideStore/SideStore/pull/853) +- [Backup]: Fix: update logic during install missed since override keyword was missing by @mahee96 in [#857](https://github.com/SideStore/SideStore/pull/857) +- Fix Repository App Previews by @neoarz in [#871](https://github.com/SideStore/SideStore/pull/871) +- Feature: Bulk sources-add in sources screen with capability to stage them before persisting into database by @mahee96 in [#888](https://github.com/SideStore/SideStore/pull/888) +- Version 0.6.0: CoreData Migrations fix including xcdatamodels and xcmappingmodels by @mahee96 in #894 +- Feature: Render in-app update description as (full) markdown by @mahee96 in #897 +- fix: typo in hasUpdate comparison by @l2dy in [#900](https://github.com/SideStore/SideStore/pull/900) +- Update SettingsViewController.swift by @neoarz in [#915](https://github.com/SideStore/SideStore/pull/915) +- WIP: Fixes for migration issues when migrating from 0.5.9 to 0.6.0 by @mahee96 in #920 +- Fix typo "levaraging" -> "leveraging" by @lafrenierejm in [#926](https://github.com/SideStore/SideStore/pull/926) +- Added StosVPN to the EM Proxy part. by @Br0des in [#940](https://github.com/SideStore/SideStore/pull/940) +- StosVPN-integration: Removed em_proxy and EmotionalDamage module in favour of stosVPN by @mahee96 in [#945](https://github.com/SideStore/SideStore/pull/945) +- Disable minimuxer ready check which shows NO WIFI/VPN error since stosVPN can work on cellular too by @mahee96 in [#935](https://github.com/SideStore/SideStore/pull/935) +- Add iOS 17.4+ JIT and mounting by @jkcoxson in [#953](https://github.com/SideStore/SideStore/pull/953) +- Add export certificate feature by @hugeBlack in [#959](https://github.com/SideStore/SideStore/pull/959) +- Feat: Add Pairing File Export URL callback and replace Wireguard with StosVPN by @stossy11 in [#962](https://github.com/SideStore/SideStore/pull/962) +- Change front-facing references to AltStore by @owoellen in [#987](https://github.com/SideStore/SideStore/pull/987) +- Update OperationError.swift for idevice_pair by @CelloSerenity in [#995](https://github.com/SideStore/SideStore/pull/995) +- Add import/export certificate feature by @hugeBlack in [#1008](https://github.com/SideStore/SideStore/pull/1008) +- Fix pairing file doc link by @CelloSerenity in [#1011](https://github.com/SideStore/SideStore/pull/1011) +- Add option for using main bundle's profile for app extensions, update AltSign & libmd by @hugeBlack in [#1012](https://github.com/SideStore/SideStore/pull/1012) +- Use main profile when refreshing by @hugeBlack in [#1013](https://github.com/SideStore/SideStore/pull/1013) + + ## 0.6.1 ### Changelog @@ -30,4 +70,4 @@ It's March and we have some big changes. We've finally included AltStore 2.0 cha - [Settings]: Fix: DisableAppLimit switch reverting back to off state even if on iOS where sparseRestore is not patched yet by @mahee96 in [#850](https://github.com/SideStore/SideStore/pull/850) - [Backup]: Fix: update logic during install missed since override keyword was missing by @mahee96 in [#857](https://github.com/SideStore/SideStore/pull/857) - Feature: Bulk sources-add in sources screen with capability to stage them before persisting into database by @mahee96 in [#888](https://github.com/SideStore/SideStore/pull/888) -- Feature: Render in-app update description as (full) markdown by @mahee96 in [#897](https://github.com/SideStore/SideStore/pull/897) \ No newline at end of file +- Feature: Render in-app update description as (full) markdown by @mahee96 in [#897](https://github.com/SideStore/SideStore/pull/897) From a725eba9e498ec7dc02f4a0fdef9e07f68336c82 Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Tue, 1 Jul 2025 10:40:26 -0600 Subject: [PATCH 16/18] Update jit.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/advanced/jit.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx index 836999bf..e01172da 100644 --- a/docs/advanced/jit.mdx +++ b/docs/advanced/jit.mdx @@ -4,10 +4,11 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps --- :::note +iOS 26 has broken JIT once again. A fix is in the works. 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 with either Wi-Fi enabled/connected or with mobile data and Wi-Fi disabled (Airplane Mode). +As an alternative, SideStore 0.6.2 includes updates to minimuxer, allowing built-in JIT functionality similar to StikDebug. To use this, simply ensure you are connected to StosVPN with either Wi-Fi connected or Airplane Mode enabled, then navigate to "My Apps," longpress the app you wish to enable JIT for, and tap "enable JIT". ::: ## Prerequisites From a0bba1363b87292538a5814c16f2df1f807dcc2b Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Tue, 1 Jul 2025 10:41:07 -0600 Subject: [PATCH 17/18] Update faq.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/faq.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/faq.mdx b/docs/faq.mdx index 3e00f7a7..f83819e8 100644 --- a/docs/faq.mdx +++ b/docs/faq.mdx @@ -20,7 +20,7 @@ SideStore's goal is to provide an untethered sideloading experience. It's a comm For users using iOS/iPadOS 16 or lower, you can activate JIT directly from the SideStore 'My Apps' page by holding down on your app and selecting 'Enable JIT'. -Users on iOS or iPadOS 17.4 or higher will need to use a solution such as StikDebug (formerly StikJIT) or SideStore nightly. Please refer to the tutorial in the [Advanced](advanced/jit) section. +Users on iOS or iPadOS 17.4 or higher can use a solution such as SideStore 0.6.2 or StikDebug (formerly StikJIT). Please refer to the tutorial in the [Advanced](advanced/jit) section. ### When will SideStore release? From 164600fb511822c710b8ede9fb21e39ed3066e8d Mon Sep 17 00:00:00 2001 From: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> Date: Tue, 1 Jul 2025 10:44:25 -0600 Subject: [PATCH 18/18] Update faq.mdx Signed-off-by: CelloSerenity <195480169+CelloSerenity@users.noreply.github.com> --- docs/faq.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/faq.mdx b/docs/faq.mdx index f83819e8..2c24cd62 100644 --- a/docs/faq.mdx +++ b/docs/faq.mdx @@ -52,7 +52,7 @@ Normally, no, as that’s an iOS and developer account limitation. Apple only al To remove this restriction (and also get a 365 day expiry), you can pay for a $99/year Apple Developer account. -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, on iOS versions 18 db5/18.0.1 and below, you can utilize the SparseRestore exploit to bypass the 3-app limit. A tutorial for using this can be found [here](advanced/sparserestore). @@ -116,7 +116,7 @@ Yep! Just click the update button when it appears! ### I want to test a SideStore version, and I want my data to stay when switching to a test version. Do I remove my app or sideload the test version via SideStore? -You can sideload via SideStore and your data should be the same. We don’t have an enrollment toggle to go to other versions. We also cannot guarantee your data transfers when testing an unofficial or nightly build. +You can sideload a nightly SideStore version via SideStore or AltServer and your data should be the same, or enable beta updates and select "nightly" in Settings. We cannot guarantee your data transfers when testing an unofficial or nightly build. ### My apps disappeared and I don't know what to do