diff --git a/docs/advanced/app-sources.mdx b/docs/advanced/app-sources.mdx index 9dc5527a..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 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. 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 @@ -17,8 +17,8 @@ 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! -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 [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json), and the [DolphiniOS Source](https://altstore.oatmealdome.me). diff --git a/docs/advanced/jit.mdx b/docs/advanced/jit.mdx index 5e2bbb7f..a0af967e 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 with either Wi-Fi enabled/connected or with mobile data and Wi-Fi disabled (Airplane Mode). ::: ## Prerequisites @@ -20,17 +22,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 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). - -2. **Install:** - Use SideStore to install StikDebug. - -3. **Installation procedures:** - Follow the standard installation procedures in the usage guide below. - ### Standard installation procedures: @@ -43,10 +34,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 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. 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). diff --git a/docs/faq.mdx b/docs/faq.mdx index 2b8e7c82..c07dec89 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). diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx index 4d972e01..3507e045 100644 --- a/docs/installation/linux.mdx +++ b/docs/installation/linux.mdx @@ -1,21 +1,28 @@ --- 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! +Before you start, make sure to have all steps completed found in the [prerequisites](prerequisites)! -1. Run altcon with Docker +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 -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 (must be run every time to install SideStore): ```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 ``` +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 requests a pairing file. Exit the app now. -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). +Now, proceed to generate your [pairing file](pairing-file). diff --git a/docs/installation/mac.mdx b/docs/installation/mac.mdx index 343c6edf..59ae94c4 100644 --- a/docs/installation/mac.mdx +++ b/docs/installation/mac.mdx @@ -1,16 +1,19 @@ --- 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)! +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 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. - * 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. +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 requests a pairing file. Exit the app now. -When you finish, follow the [post-install instructions](post-install). +Now, proceed to generate your [pairing file](pairing-file). diff --git a/docs/installation/pairing-file.mdx b/docs/installation/pairing-file.mdx index 5dda3158..0acdd04d 100644 --- a/docs/installation/pairing-file.mdx +++ b/docs/installation/pairing-file.mdx @@ -1,52 +1,49 @@ --- title: Pairing File description: Pairing files are essential to SideStore's functionality. -sidebar_position: 2 +sidebar_position: 5 --- -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 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 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: +- [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)) ## Pairing Instructions -### Windows +### 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. -1. Install iTunes from Apple's website ([64-bit](https://apple.com/itunes/download/win64) or [32-bit](https://apple.com/itunes/download/win32)). +### Windows (64-bit) + +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, open iDevicePair, 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 +### Linux -1. Download `iDevicePair--macos-universal.dmg`. Open the file and drag "iDevicePair" to your Applications folder. +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. 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, 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. -### 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! -::: - -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. +## Next steps +Now, follow the [post-install instructions](post-install). diff --git a/docs/installation/post-install.mdx b/docs/installation/post-install.mdx index 13ed303f..eea42b45 100644 --- a/docs/installation/post-install.mdx +++ b/docs/installation/post-install.mdx @@ -9,11 +9,12 @@ 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". - * If successful, this will open a blank Safari tab or open to your home screen, accompanied by a notification notating this. +3. If you haven't already, 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. 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). diff --git a/docs/installation/prerequisites.mdx b/docs/installation/prerequisites.mdx index 9e8b8407..64af168c 100644 --- a/docs/installation/prerequisites.mdx +++ b/docs/installation/prerequisites.mdx @@ -9,18 +9,13 @@ 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](/docs/installation/windows.mdx), [macOS](/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/)). -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. +- 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](/docs/installation/linux) (Linux support is experimental) computer +- 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/)) ## StosVPN @@ -29,8 +24,11 @@ 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 -Now, go to the next page to generate your pairing file! +Next, follow the installation instructions for your operating system! +- [macOS](mac) +- [Windows (64-bit)](windows) +- [Linux (experimental)](linux) diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx index 3ddd8d65..fd257110 100644 --- a/docs/installation/windows.mdx +++ b/docs/installation/windows.mdx @@ -4,15 +4,18 @@ 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)! +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, 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`. -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. +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. + * Navigate to the 'Privacy and Security' section. + * Turn on 'Developer Mode' at the bottom. +5. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now. -After you finish, follow the [post-install instructions](post-install). +Now, proceed to generate your [pairing file](pairing-file). 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 diff --git a/docs/troubleshooting/common-issues.mdx b/docs/troubleshooting/common-issues.mdx index c81601c9..8348ca7d 100644 --- a/docs/troubleshooting/common-issues.mdx +++ b/docs/troubleshooting/common-issues.mdx @@ -16,17 +16,17 @@ 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 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 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 @@ -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. diff --git a/docs/troubleshooting/troubleshooting.mdx b/docs/troubleshooting/troubleshooting.mdx index e90e2271..91fd0fe8 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 +#### 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 +#### 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 +### 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,12 +61,12 @@ 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 -#### 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: @@ -75,41 +75,24 @@ 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 -#### 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". -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 -#### 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: +- 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. @@ -119,12 +102,14 @@ 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? -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). 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. 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. ::: 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**. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx b/i18n/es/docusaurus-plugin-content-docs/current/intro.mdx index 0d3fafdb..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 -:::Peligro +:::danger This documentation is currently not fully translated into Spanish. Please consider helping us by translating our docs! 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', ], };