Skip to content
16 changes: 8 additions & 8 deletions docs/advanced/alternative.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ import TabItem from '@theme/TabItem';
Before you start, make sure to have installed usbmuxd.
1. Ensure you have usbmuxd installed and updated by running `sudo apt install -y usbmuxd` in the Linux terminal.
2. Install either Docker or Podman on your machine.
3. Plug in your secondary iDevice. If you receive a prompt, select "trust" and enter your passcode.
3. Plug in your secondary iPhone, iPad, or iPod touch. If you receive a prompt, select "Trust" and enter your passcode.
4. Now, run Altcon with Docker or Podman using the following command (may require `sudo`):

Docker setup:
Expand All @@ -43,14 +43,14 @@ import TabItem from '@theme/TabItem';
Steps:
1. Setup AltServer on macOS/Windows using instructions above
2. Install AltStore to one device using AltServer
3. Sign in Apple ID in AltStore
3. Sign in Apple Account in AltStore
4. Export Certificate
5. Delete AltStore

Then for each device:
1. Install SideStore using AltServer with the same Apple ID (Hold [Option/Mac, Shift/Windows] when clicking AltServer -> Install IPA -> Select SideStore.ipa)
1. Install SideStore using AltServer with the same Apple Account (Hold [Option/Mac, Shift/Windows] when clicking AltServer -> Install IPA -> Select SideStore.ipa)
2. Import certificate
3. Sign in Apple ID in SideStore (We need to sign in after importing the certificate otherwise it won't let you sign in without revoking AltStore's certificate)
3. Sign in Apple Account in SideStore (We need to sign in after importing the certificate otherwise it won't let you sign in without revoking AltStore's certificate)
4. Sideload

When the old certificate expires:
Expand All @@ -69,7 +69,7 @@ The SideStore WireGuard VPN **only works on SideStore versions between 0.3.1-0.6

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

1. Download the WireGuard app from the [Official App Store](https://apps.apple.com/us/app/wireguard/id1441195209).
1. Download the WireGuard app from the [Apple App Store](https://apps.apple.com/app/wireguard/id1441195209).
2. Also, download the WireGuard config found [here](https://github.com/SideStore/SideStore/releases/download/0.3.1/SideStore.conf).
3. Open WireGuard, and press the 'Add a Tunnel' or '+' button.
4. Select 'Create from file or archive', and choose the SideStore.conf file.
Expand Down Expand Up @@ -178,16 +178,16 @@ The SparseRestore "Bypass 3 app limit" exploit **only works on iOS/iPadOS versio
:::

#### Prerequisites
* An iDevice running versions supported by the SparseRestore exploit (see note above).
* An iPhone or iPad running versions supported by the SparseRestore exploit (see note above).
* At least 1 free app slot.
* SideStore version 0.5.9 or later. You can find the latest versions [here](https://github.com/SideStore/SideStore/releases).
* To perform this exploit, you MUST have **Find My** turned off on your iDevice during the process. It will not work otherwise. Here is how you can turn it off:
* To perform this exploit, you MUST have **Find My** turned off on your iPhone or iPad during the process. It will not work otherwise. Here is how you can turn it off:
- Open the Settings app.
- Tap on your name at the top.
- Tap on Find My.
- Tap on Find My iPhone/iPad.
- Turn off Find My iPhone/iPad.
- You may be required to enter your Apple ID password to confirm.
- You may be required to enter your Apple Account password to confirm.

> **Note:** You may still not be able to turn off Find My since having Stolen Device Protection on might prevent you from turning it off. Turn off Stolen Device Protection before trying to turn off Find My.

Expand Down
2 changes: 1 addition & 1 deletion docs/advanced/anisette.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ 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 recommended 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 Account 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.

Expand Down
6 changes: 3 additions & 3 deletions docs/advanced/jit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,14 +20,14 @@ As an alternative, SideStore 0.6.2 includes updates to minimuxer, allowing built
:::

## Prerequisites
* An iDevice running iOS/iPadOS 17.4-all iOS 18 versions, excluding 18.4b1. If you are on 17.0-17.3, you must use an alternative such as [SideJITServer](https://github.com/nythepegasus/SideJITServer). SideStore's JIT enabler will only work on iOS 26 if your device is about 4+ years old (non-TXM capable).
* An iPhone or iPad running iOS/iPadOS 17.4-all iOS 18 versions, excluding 18.4b1. If you are on 17.0-17.3, you must use an alternative such as [SideJITServer](https://github.com/nythepegasus/SideJITServer). SideStore's JIT enabler will only work on iOS 26 if your device is about 4+ years old (non-TXM capable).

## StikDebug installation procedures:

1. **Install StikDebug**
Install StikDebug from the [Apple App Store](https://apps.apple.com/us/app/stikdebug/id6744045754). Note: you can't sideload apps with VPNs on a free account.
Install StikDebug [from the Apple App Store](https://apps.apple.com/app/stikdebug/id6744045754) or [from the AltStore PAL source](https://api.altstore.io/source/stikdebug.xyz/apps.json?app=com.stik.sj).

:::note Something nice- the VPN present in StikDebug functions the same as one used in SideStore, meaning you can also use it to install and refresh apps in SideStore, similar to LocalDevVPN.
:::note The VPN present in StikDebug functions the same as one used in SideStore, meaning you can also use it to install and refresh apps in SideStore, similar to LocalDevVPN.
:::

2. **Place the Pairing File:**
Expand Down
6 changes: 3 additions & 3 deletions docs/advanced/pairing-file.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@ title: Pairing File
description: A guide on manually reimporting your pairing file.
---
:::warning
Caution, if you update or reset your iDevice, your pairing file will expire and you will need to reimport it. This also occurs at random times. This is simply because of how Apple's software works, and there is nothing we can do at this point to fix it. This guide instructs you how to manually replace your pairing file with iloader.
Your pairing file may expire and need to be reimported if you update or reset your iPhone, iPad, or iPod touch. This also occurs at random times. This is Apple's fault and there is nothing we can do to fix it. This guide instructs you how to manually replace your pairing file with iloader.
:::

## Replacing your pairing file
1. Make sure you have followed the steps in the [install guide](../installation/prerequisites) to install and setup iloader and SideStore. If iloader prompts you to update it, click 'Yes'.
2. For most reliable results, connect your iDevice to your computer via USB cable, but if your device only appears wirelessly, that should work too.
1. Make sure you have followed the steps in the [install guide](/docs/installation/prerequisites) to install and setup iloader and SideStore. If iloader prompts you to update it, click 'Yes'.
2. For most reliable results, connect your iPhone, iPad, or iPod touch to your computer via a USB cable. If your device only appears wirelessly, that should work too.
3. Click 'Manage Pairing File'.
4. To the right of "SideStore" and any other apps you wish, click 'Place'. "Pairing file placed successfully!" should appear in green.
77 changes: 57 additions & 20 deletions docs/installation/install.mdx
Original file line number Diff line number Diff line change
@@ -1,32 +1,69 @@
---
title: Install
description: Installing SideStore to your iDevice
description: Installing SideStore to your iPhone, iPad, or iPod touch
sidebar_position: 2
---

```mdx-code-block
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
```

Before you start, make sure to download all software and complete all setup found in the [prerequisites page](prerequisites)!

## Installing SideStore
### On your Computer
1. Connect your iDevice to your computer via cable. If you are prompted, trust the computer and enter your passcode.
### On your computer
1. Connect your iPhone, iPad, or iPod touch to your computer via a USB cable. If you are prompted, trust the computer and enter your passcode.
2. Open iloader.
3. Sign in to an Apple Account (It doesn't need to be the account associated with the device. Remember that it is case-sensitive!).
4. Select your iDevice.
3. Sign in with your Apple Account. (It doesn't need to be the account associated with the device. Remember that it is case-sensitive!)
4. Select your iPhone, iPad, or iPod touch.
5. Select 'Install SideStore (Stable)'.

### On your iDevice
1. Open the Settings app.
2. Navigate to 'General', and then 'VPN & Device Management'.
3. Approve the "Developer App" under the Apple Account's email.
4. Navigate to 'Privacy and Security'.
5. Scroll to the bottom, and turn on "Developer Mode". Your phone will restart.
6. Open LocalDevVPN and select 'Connect'.
7. Open SideStore.
9. Sign in to the Apple Account you used with iloader.
10. Navigate to 'My Apps'.
11. Tap the '7 DAYS' counter to the right of SideStore to manually refresh it ("7" represents the number of days until an app's expiry, it will update dynamically to show the number of days left. Tap it to refresh the associated app.).
12. If you receive a prompt asking to revoke or create a new signing certificate, tap 'Yes' or 'Refresh Now'.

If this process is successful, SideStore will open your device to your home screen (accompanied by a notification), and SideStore will be available again within a few seconds.
### On your iPhone, iPad, or iPod touch
<Tabs groupId="ios-versions">
<TabItem value="15" label="iOS/iPadOS 15.0-15.8.5">
1. Open the Settings app.
2. Navigate to 'General', and then 'VPN & Device Management'.
3. Under the "Developer App" section, select the option named after your Apple Account.
4. Select "Trust [Apple Account name]", then select "Trust" to confirm.
5. Open LocalDevVPN and select 'Connect'.
6. Open SideStore.
7. Sign in to the Apple Account you used with iloader.
8. Navigate to 'My Apps'.
9. Tap the '7 DAYS' counter to the right of SideStore to manually refresh it and finish setting up SideStore. (7 represents the number of days until an app's expiry. It will update dynamically to show the number of days left. Tap it to refresh the associated app.)
10. If you receive a prompt asking to revoke or create a new signing certificate, tap 'Yes' or 'Refresh Now'.
</TabItem>
<TabItem value="16" label="iOS/iPadOS 16.0-17.7.7">
1. Open the Settings app.
2. Navigate to 'General', and then 'VPN & Device Management'.
3. Under the "Developer App" section, select the option named after your Apple Account.
4. Select "Trust [Apple Account name]", then select "Trust" to confirm.
5. Navigate to 'Privacy and Security'.
6. Scroll to the bottom, and turn on "Developer Mode". Your device will restart.
7. Open LocalDevVPN and select 'Connect'.
8. Open SideStore.
9. Sign in to the Apple Account you used with iloader.
10. Navigate to 'My Apps'.
11. Tap the '7 DAYS' counter to the right of SideStore to manually refresh it and finish setting up SideStore. (7 represents the number of days until an app's expiry. It will update dynamically to show the number of days left. Tap it to refresh the associated app.)
12. If you receive a prompt asking to revoke or create a new signing certificate, tap 'Yes' or 'Refresh Now'.
</TabItem>
<TabItem value="18" label="iOS/iPadOS 18.0-26.2" default>
1. Open the Settings app.
2. Navigate to 'General', and then 'VPN & Device Management'.
3. Under the "Developer App" section, select the option named after your Apple Account.
4. Select "Trust [Apple Account name]", then select "Allow & Restart".
5. Enter your passcode to confirm you want to trust the app.
6. Navigate to 'Privacy and Security'.
7. Scroll to the bottom, and turn on "Developer Mode". Your device will restart.
8. Open LocalDevVPN and select 'Connect'.
9. Open SideStore.
10. Sign in to the Apple Account you used with iloader.
11. Navigate to 'My Apps'.
12. Tap the '7 DAYS' counter to the right of SideStore to manually refresh it and finish setting up SideStore. (7 represents the number of days until an app's expiry. It will update dynamically to show the number of days left. Tap it to refresh the associated app.)
13. If you receive a prompt asking to revoke or create a new signing certificate, tap 'Yes' or 'Refresh Now'.
</TabItem>
</Tabs>

Caution, if you update or reset your iDevice, your pairing file may expire, requiring you to replace it using [this guide](../advanced/pairing-file). This also occurs at random times because of Apple's software.
If this process is successful, SideStore will open your device to your Home Screen (accompanied by a notification). SideStore will be available again within a few seconds.

Your pairing file may expire if you update or reset your iPhone, iPad, or iPod touch. If this happens, you'll need to replace it using [this guide](/docs/advanced/pairing-file). This also occurs at random times because of Apple's software.
49 changes: 31 additions & 18 deletions docs/installation/prerequisites.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,25 +9,18 @@ import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
```

SideStore's installation process may seem tricky, but with the ***one-time*** use of a computer and some time, you'll have SideStore on your device!

## Requirements

To install SideStore, you will need:

- An iPhone/iPad [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 14 or higher
- A computer (one-time)
- An Apple Account
- An iPhone, iPad, or iPod touch [with a passcode](https://support.apple.com/en-us/119586) running iOS/iPadOS 15.0 or higher
- A computer running Windows 7 or higher, macOS High Sierra or higher, or an up-to-date Linux distribution; only for initial install
- An Apple Account (also called an Apple ID)
- 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 and easy process, but you should [leave time for troubleshooting](/docs/troubleshooting)

## Preparing Your Devices

### On your iPhone/iPad:

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

1. Install the LocalDevVPN app from the [Apple App Store](https://apps.apple.com/us/app/localdevvpn/id6755608044). If you are in the EU and it doesn't appear, you can try the [AltStore PAL source](https://intradeus.github.io/http-protocol-redirector?r=altstore-pal://source?url=https://adp.se2crid.me/). Note: you can't sideload VPNs properly on a free developer account.
1. Install the LocalDevVPN app [from the Apple App Store](https://apps.apple.com/app/localdevvpn/id6755608044) or [from the AltStore PAL source](https://api.altstore.io/source/adp.se2crid.me?app=com.jkcoxson.LocalDevVPN).
2. Connect to the VPN. If you are prompted to "Allow VPN Configurations", tap 'Allow' and enter your passcode.

This VPN is required to be turned on any time you wish to install, update, or refresh apps in SideStore.
Expand All @@ -36,15 +29,35 @@ Now, follow the instructions corresponding to your computer's OS:

<Tabs groupId="operating-systems">
<TabItem value="mac" label="macOS">
1. Download and install iloader for [Mac](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-universal.dmg).
Download and install [iloader](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-universal.dmg).
</TabItem>
<TabItem value="win" label="Windows">
1. Download and install [iTunes](https://apple.co/ms).
2. Download the iloader installer ([.exe](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.exe) or [.msi](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.msi)). (Note: The iloader installer .exe is currently flagged as a virus/trojan, we are positive it's not and are looking into it, but in the meantime we recommend you download the .msi).
:::warning
32-bit versions of Windows, as well as Windows 10 on Arm, are not supported.

<details>
<summary>**Most versions of Windows are 64-bit.** However, if you want to determine if you are using an unsupported version of Windows or not, you can follow these instructions.</summary>
1. Open the Run dialog with Windows+R (or Command+R or Super+R).
2. Enter `control /name microsoft.system`. The Control Panel will open.
3. Under the "System" tab, locate "System type".

* If you have a "32-bit Operating System", your version of Windows is not supported.
* If you have an "ARM64 processor" AND you're using Windows 10, your version of Windows is not supported.
</details>
:::

1. Download and install iTunes [from the Microsoft Store](https://apps.microsoft.com/store/detail/9PB2MZ1ZMB1S) or [directly from Apple](https://www.apple.com/itunes/download/win64).
2. Download the iloader installer [as an MSI](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.msi) (recommended) or [as an EXE](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.exe).
3. Run the installer.
</TabItem>
<TabItem value="linux" label="Linux">
1. Download and install `usbmuxd` (may be preinstalled for your distro, otherwise install with your package manager).
2. Download and install iloader for your distro ([.deb](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.deb) for Debian/Ubuntu, [.rpm](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-x86_64.rpm) for Fedora/openSUSE, [.AppImage](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.AppImage) for other).
:::warning
Only 64-bit distributions are supported.

**Most Linux distributions are 64-bit.** To determine if you're using a 64-bit distribution, open a terminal and run `uname -m`. The expected output is `x86_64`.
:::

1. Download and install `usbmuxd`. It may be preinstalled with your distribution, otherwise you can install it with your package manager: a Google search for "install usbmuxd [distribution name]" might help you.
2. Download and install iloader for your distribution. It is available as a [DEB](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.deb) for Debian/Ubuntu, [RPM](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-x86_64.rpm) for Fedora/openSUSE, and as an [AppImage](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.AppImage) for others. (There are also community-maintained packages, such as [this one on the Arch Linux AUR](https://aur.archlinux.org/packages/iloader-bin), but please know that we cannot guarantee their safety or security. You should always do your due diligence before installing unknown packages onto your system.)
</TabItem>
</Tabs>
</Tabs>
Loading