Skip to content

Commit c19dc61

Browse files
committed
iloader
1 parent d17a796 commit c19dc61

File tree

14 files changed

+109
-207
lines changed

14 files changed

+109
-207
lines changed

docs/advanced/jit.mdx

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,23 @@ description: A tutorial on how to enable Just-in-Time (JIT) Compilation for apps
44
---
55

66
:::note
7-
iOS 26 has broken JIT once again. An update has been released to StikDebug with a fix, but support is **very** limited. As of writing (Sep 16), the only supported apps are:
7+
iOS 26 has broken JIT once again. An update has been released to StikDebug with a fix, but support is limited. As of writing (Nov 10), the only supported apps are:
88
* UTM
99
* Amethyst
1010
* MeloNX
11-
* maciOS (not fully released)
11+
* maciOS
12+
* DolphiniOS
13+
* Geode
1214

1315
Please keep an eye on our announcements channel in our Discord server and on the [idevice server](https://discord.gg/mACqxMxP3X)'s announcements and compatibility channels for further updates.
1416

15-
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).
17+
There are many methods to enabling JIT, depending on your iOS version. 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).
1618

1719
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".
1820
:::
1921

2022
## Prerequisites
21-
* An iDevice running iOS/iPadOS 17.4-18.6, excluding 18.4b1. If you are on 17.0-17.3, you must use an alternative such as [SideJITServer](https://github.com/nythepegasus/SideJITServer). As stated above, versions newer than 18.6 are currently unsupported.
23+
* 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).
2224

2325
## StikDebug installation with Apple App Store
2426

@@ -37,7 +39,7 @@ As an alternative, SideStore 0.6.2 includes updates to minimuxer, allowing built
3739
Open and close StikDebug to build the app's folder in files, then import the same **pairing file** you use for SideStore using idevice pair. For more information on this process, see [here](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md).
3840

3941
2. **Mount the DDI:**
40-
Open StikDebug with Wi-Fi and the VPN connected and the pairing file imported, then close it and reopen it. This mounts the DDI and must be performed every time you restart your idevice.
42+
Open StikDebug with Wi-Fi and the VPN connected and the pairing file imported, then close it and reopen it. This mounts the DDI and must be performed every time you restart your iDevice.
4143

4244
## To enable JIT:
4345

docs/advanced/pairing-file.mdx

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Pairing File
3+
description: A guide on manually reimporting your pairing file.
4+
---
5+
:::warning
6+
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 reimport your pairing file into SideStore with iloader.
7+
:::
8+
9+
## Reimporting your pairing file
10+
1. Make sure you have followed the steps in the [install guide](../installation/prerequisites) to install and setup iloader and SideStore.
11+
2. For best results, connect your iDevice to your computer via USB cable, but if your device appears wirelessly that works too.
12+
3. Click "Manage Pairing File"
13+
4. Next to "SideStore" and any other apps you wish, click "Place Pairing File". "Pairing file placed successfully!" should appear in green.

docs/faq.mdx

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,16 @@ This is a list of frequently asked questions for SideStore. This has a list of c
1010

1111
## What is SideStore?
1212

13-
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.
13+
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://apps.apple.com/us/app/stosvpn/id6744003051) 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.
1414

1515
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.
1616

1717
(Contributions are welcome! 🙂)
1818

19+
### What limitations does SideStore have?
20+
21+
If using a free Apple Account, SideStore can only install 3 apps (including itself) at a time. Additionally, only 10 different apps may be installed in a week. (Referred to as App IDs).
22+
1923
### Can I activate JIT?
2024

2125
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'.
@@ -32,7 +36,7 @@ Yes you can, just like AltStore!
3236

3337
### Does SideStore have AltStore (beta) features?
3438

35-
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.
39+
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 necessary.
3640

3741
### Will having the VPN on drain my battery?
3842

@@ -52,7 +56,7 @@ Normally, no, as that’s an iOS and developer account limitation. Apple only al
5256

5357
To remove this restriction (and also get a 365 day expiry), you can pay for a $99/year Apple Developer account.
5458

55-
Alternatively, on iOS versions 18 db5/18.0.1 and below, you can utilize the SparseRestore exploit to bypass the 3-app limit.
59+
Alternatively, you can use LiveContainer, or on iOS versions 18 db5/18.0.1 and below, you can utilize the SparseRestore exploit to bypass the 3-app limit. (doesn't bypass the 10 app-id limit)
5660

5761
A tutorial for using this can be found [here](advanced/sparserestore).
5862

@@ -62,29 +66,29 @@ Please make a GitHub issue on our GitHub page to make a bug report or feature re
6266

6367
### I am a developer, how does this affect me?
6468

65-
It doesn’t affect you directly, other than maybe an update to AltKit when/if we get our additions.
69+
Your apps shouldn't need any modification to work with SideStore!
6670

6771
### Do I need to install AltStore to install SideStore?
6872

69-
Nope, you can sideload SideStore directly following our guides for [Windows](/docs/installation/windows.mdx), [macOS](/docs/installation/mac.mdx), and [Linux](/docs/installation/linux.mdx) since currently it operates like AltStore while signing.
73+
Nope, you can sideload SideStore directly following our helpful guide!
7074

71-
### As a user, I’m having trouble logging into SideStore. I get an error
75+
### As a user, I’m having trouble logging into SideStore. I get an error.
7276

7377
There are many reasons this can happen, but the most common issue is a temporary Anisette server downtime. You can currently change the Anisette server on your device’s Settings app in SideStore under “Anisette URL”.
7478

7579
### Is SideStore going to have a Storefront?
7680

7781
We currently have a Community Source! Source URL: https://community-apps.sidestore.io/sidecommunity.json
7882

79-
We also have a service called [SideStore Connect](https://connect.sidestore.io) which allows devs to publish their own apps.
83+
We also have a service called [SideStore Connect](https://connect.sidestore.io) which allows developers to publish their own apps.
8084

8185
### Why does my app have an update called "pacer test"?
8286

8387
This was a test update to see if there were problems between major versions, and shouldn’t be seen during normal use. If you see this issue, and it’s after release, then reinstall SideStore or report it as a bug.
8488

8589
### Why do my JIT based apps not automatically activate JIT?
8690

87-
We currently don’t have an automatic JIT activation method, and if we did you would need StosVPN on.
91+
We currently don’t have an automatic JIT activation method, and if we did you would need StosVPN on. Alternatively, you can use StikDebug.
8892

8993
### Does SideStore have an iPadOS UI?
9094

@@ -98,10 +102,6 @@ These Macs are not real, and they are automatically generated by the Anisette se
98102

99103
Older Anisette servers that are used by many users are known to cause locking of Apple ID's. Please use one of the official Anisette servers, or host your own [anisette-v3-server](advanced/anisette).
100104

101-
### Why do I get error -36607?
102-
103-
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.
104-
105105
### Can I transfer my AltStore/Sideloadly apps?
106106

107107
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.
@@ -118,21 +118,17 @@ Yep! Just click the update button when it appears!
118118

119119
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.
120120

121-
### My apps disappeared and I don't know what to do
122-
123-
Don't panic! Re-sideload the apps without removing them from your device, and your data should be fine. Unfortunately it's possible that your deactivated apps are gone, but to confirm that just refresh SideStore to see if they come back.
124-
125-
### I'm unable to select my pairing file with any file type
121+
### My apps disappeared from SideStore and I don't know what to do!
126122

127-
Make sure your pairing file's extension ends with `.mobiledevicepairing` or `.plist`. If it doesn't, double check to see if you had zipped your pairing file before sending it to your phone. Failing to do so may lead to the file being corrupted during transport. Also, when signing SideStore with a certificate, you won't be able to select the pairing file from within app. You can try moving the pairing file to the root directory of the SideStore folder in the Files app in "On My iPhone/iPad", and naming it `ALTPairingFile.mobiledevicepairing`. If you do not see the SideStore folder in the files app, connect your phone to your computer, and you can drag and drop the pairing file to the files of the SideStore app. Ensure to change it to name mentioned above. Note that it is case sensitive.
123+
Don't panic! Re-sideload the apps as usual without removing them from your device, and your data should be fine. Unfortunately it's possible that your deactivated apps are gone, but to confirm that, just refresh SideStore to see if they come back.
128124

129125
### Cannot start DebugServer
130126

131127
There is times when the DebugServer doesn't work. However, there is a fix you can try:
132128

133129
**Make a new pairing file**
134130

135-
To start the process of using a new pairing file you go to settings tab and click Reset Pairing file, and you accept the prompt. Then you just follow the [Pairing File instructions](installation/pairing-file).
131+
Reimport your pairing file using iloader.
136132

137133
### Currently Known issues
138134

docs/installation/install.mdx

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: Install
3+
description: Installing SideStore to your iDevice
4+
sidebar_position: 2
5+
---
6+
## Installing SideStore
7+
1. Connect your iDevice to your computer via cable. If you are prompted, trust the computer and enter your passcode.
8+
2. Open iloader.
9+
3. Sign in to your Apple Account
10+
4. Select your iDevice
11+
3. Select "Install SideStore".
12+
13+
### On your iDevice
14+
Do the following:
15+
1. Open the Settings app.
16+
2. Navigate to 'General', and then 'VPN & Device Management'.
17+
3. Approve the "Developer App" under your Apple Account's email.
18+
4. Navigate to 'Privacy and Security'.
19+
5. Scroll to the bottom, and turn on 'Developer Mode'. Your phone will restart.
20+
6. Open StosVPN and select 'Connect'.
21+
7. Open SideStore.
22+
9. Sign in with your Apple Account.
23+
10. Navigate to "My Apps".
24+
11. Tap the "x DAYS" button to the right of SideStore, (x is the number of days until an app's expiry).
25+
12. A prompt asking to create a new signing certificate should appear, tap "Refresh Now".
26+
27+
If this process is successful, SideStore will open your device to your home screen, accompanied by a notification, and SideStore will be avaliable again within a few seconds.
28+
29+
Caution, if you update or reset your iDevice, your pairing file will expire and you will need to reimport it using [this guide](../advanced/pairing-file). This also occurs at random times because of Apple's software.
30+
31+
If you reinstall SideStore using iloader, your certificate may be revoked, requiring you to manually refresh it again.
32+
33+
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).
34+

docs/installation/linux.mdx

Lines changed: 0 additions & 30 deletions
This file was deleted.

docs/installation/mac.mdx

Lines changed: 0 additions & 18 deletions
This file was deleted.

docs/installation/pairing-file.mdx

Lines changed: 0 additions & 46 deletions
This file was deleted.

docs/installation/post-install.mdx

Lines changed: 0 additions & 25 deletions
This file was deleted.

0 commit comments

Comments
 (0)