Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
3cd5eb5
Updated the translation of the installation part.
Starbroke Jul 29, 2025
0c45ab8
Updated previous translation with the newest docs.
Starbroke Aug 4, 2025
b8fb74d
Updated app-source translation with several other translation fixed.
Starbroke Aug 4, 2025
5e0b557
.gitignore file
Starbroke Aug 5, 2025
2497c96
updated JIT translations.
Starbroke Aug 6, 2025
885d6db
Some translation change.
Starbroke Sep 6, 2025
40a4ef8
Merge branch 'main' of github.com:SideStore/SideStore-Docs into zh_cn…
Starbroke Sep 6, 2025
394467f
Finished advanced part translation and updated installation translation.
Starbroke Sep 6, 2025
c7fa0f9
Changed links and some translations.
Starbroke Nov 11, 2025
bd38e35
Merge branch 'main' into zh_cn_translation
Starbroke Nov 11, 2025
72a8f7f
Merge pull request #165 from Starbroke/zh_cn_translation
Starbroke Nov 11, 2025
0798e71
Revert "Changed some translations and changed links" (#166)
polymo1 Nov 11, 2025
ebf99e8
Update TRANSLATION_GUIDE.md
CelloSerenity Nov 14, 2025
530060f
Punctuation is important, kids
CelloSerenity Nov 14, 2025
372ff8d
Update links
CelloSerenity Nov 14, 2025
c521c54
Translated NL (#168)
Macleykun Nov 16, 2025
99d5401
Update common-issues.mdx
CelloSerenity Nov 17, 2025
df2629d
Update common-issues.mdx
CelloSerenity Nov 17, 2025
ed02b67
iloader terminology change
CelloSerenity Nov 17, 2025
c643f31
Update faq.mdx
CelloSerenity Nov 17, 2025
b70a7a8
Update troubleshooting.mdx
CelloSerenity Nov 17, 2025
6b0e608
Update faq.mdx
CelloSerenity Nov 17, 2025
771967c
Update troubleshooting.mdx
CelloSerenity Nov 17, 2025
e36e5cc
Merge branch 'SideStore:main' into iloader
CelloSerenity Nov 17, 2025
a881562
Update pairing file guide for clarity
CelloSerenity Nov 17, 2025
ad9082d
Update intro.mdx
CelloSerenity Nov 17, 2025
0e17720
Update faq.mdx
CelloSerenity Nov 17, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 reimport your pairing file into SideStore with iloader.
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.
:::

## Reimporting your pairing file
## 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.
2. For best results, connect your iDevice to your computer via USB cable, but if your device appears wirelessly that works too.
3. Click "Manage Pairing File"
4. To the right of "SideStore" and any other apps you wish, click "Place Pairing File". "Pairing file placed successfully!" should appear in green.
4. To the right of "SideStore" and any other apps you wish, click "Place". "Pairing file placed successfully!" should appear in green.
22 changes: 3 additions & 19 deletions docs/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -46,10 +46,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.

### Updating SideStore hangs towards the end

Go to the homescreen for it to finish. We don't know why this happens, but it might have to do with using a VPN to direct `installd` to refresh SideStore (itself).

### Can I sign more than 3 apps to be active?

Normally, no, as that’s an iOS and developer account limitation. Apple only allows 3 apps to be installed using a free Apple Developer account.
Expand All @@ -62,7 +58,7 @@ A tutorial for using this can be found [here](advanced/sparserestore).

### I have a problem or bug or request for a feature or quality of life improvement

Please make a GitHub issue on our GitHub page to make a bug report or feature request (with appropriate labels)!
Please check [common issues](troubleshooting/common-issues) and existing GitHub issues, if you don't find it, please create a new a GitHub issue on our GitHub page to make a bug report or feature request (with appropriate labels)!

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

Expand Down Expand Up @@ -116,22 +112,10 @@ 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 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 from SideStore and I don't know what to do!

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.

### Cannot start DebugServer

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

**Make a new pairing file**

[Reimport your pairing file using iloader.](advanced/pairing-file)
You can sideload a nightly SideStore version via SideStore or iloader and your data should remain, or enable beta updates and select "nightly" in Settings. We cannot guarantee your data transfers when testing an unofficial or nightly build.

### Currently Known issues

If you're currently having issues and want to know if we already know about them. Then check out our GitHub issue page which has a list of known issues and ways to mitigate some of the issues you might be having. Some of the issues in this list might be known that are not there, but are in the GitHub issues section. https://github.com/SideStore/SideStore/issues/490
If you're currently having issues and want to know if we already know about them, check out our GitHub issue page and the troubleshooting page which has a list of known issues and ways to mitigate some of the issues you might be having. Some of the issues in this list might be known that are not there, but are in the GitHub issues section. [GitHub](https://github.com/SideStore/SideStore/issues/490), [troubleshooting](/troubleshooting/troubleshooting).

If you have any issues that aren't in this list. Just make a GitHub issue or [join our discord.](https://dis.sidestore.io/)
2 changes: 1 addition & 1 deletion docs/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ Welcome to SideStore!

SideStore makes sideloading applications on iOS/iPadOS 14+ devices easy.

To get started, go to the [Prerequisites](/docs/installation/prerequisites.mdx) page and follow the instructions.
To get started, go to the [Prerequisites](installation/prerequisites.mdx) page and follow the instructions.
34 changes: 19 additions & 15 deletions docs/troubleshooting/common-issues.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Common Issues
description: Common issues found in SideStore not associated with error codes.
description: Common issues encountered using SideStore.
---

:::warning
Expand All @@ -11,27 +11,29 @@ This page is currently a work in progress. The information provided should be ac

## Common Issues with SideStore

### I am receiving error code: "X"
### I have an issue with the latest nightly
#### Cause
Our nightly builds include bleeding-edge features and improvements, some of which may cause instablity.
#### Resolution
Check our helpful [list of error codes](error-codes)!
Switch to the latest stable build. Please do not create issues or request support for bugs encountered in nightly builds.

### AFC Connection Failure
### I am receiving error code: "X"
#### Cause
Connection issues or an invalid pairing file.
An error occurred.
#### Resolution
1. Attempt to reconnect. Ensure Wi-Fi and StosVPN are connected.
2. Load and import a new pairing file using iloader.
Check our helpful [list of error codes](error-codes)!

### No Wi-Fi or VPN Connection
### AFC Connection Failure / No Wi-Fi or VPN Connection
#### Cause
Connection issues with the minimuxer service.
#### Resolution
1. If using WireGuard, switch to StosVPN
2. Turn off any DNS-blockers
3. Try again (spamming the button sometimes helps)
4. Restart SideStore
5. Restart StosVPN
6. Load and import a new pairing file using iloader.
3. Ensure StosVPN and Wi-Fi are both connected
4. Try again (spamming the button sometimes helps)
5. Restart SideStore
6. Restart StosVPN
7. [Replace your pairing file](../advanced/pairing-file) using iloader.

### SideStore Hangs Partway Through Installation
#### Cause
Expand All @@ -57,8 +59,10 @@ 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. Import your 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


### I couldn't find my issue here
#### Resolution
Please check our [troubleshooting list](troubleshooting).
6 changes: 3 additions & 3 deletions docs/troubleshooting/error-codes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ This means that SideStore could not locate the file to download or install, most

`SideStore.OperationError 1006`

This means that your pairing file has been corrupted. [Reimport it with iloader](../advanced/pairing-file).
This means that your pairing file has been corrupted. [Replace it using iloader](../advanced/pairing-file).

#### (1007) This app is in an invalid format.

Expand Down Expand Up @@ -105,7 +105,7 @@ Your device was unable to receive data from a V3 anisette server. Please try aga

`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 connected. If that doesn't work, [reimport your pairing file with iloader](../advanced/pairing-file).
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 connected. If that doesn't work, [replace your pairing file using iloader](../advanced/pairing-file).


## Minimuxer Errors
Expand All @@ -120,7 +120,7 @@ This means you are attempting to enable JIT on an unsupported iOS version. SideS

`minimuxer.MinimuxerError 27`

Ensure Wi-Fi and StosVPN are both connected. If the error doesn't resolve, [reimport your pairing file with iloader](../advanced/pairing-file).
Ensure Wi-Fi and StosVPN are both connected. If the error doesn't resolve, [replace your pairing file with iloader](../advanced/pairing-file).


## Apple Developer Errors
Expand Down
17 changes: 8 additions & 9 deletions docs/troubleshooting/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ description: A guide to troubleshooting SideStore in situations without an error
- Opening iTunes and checking 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.

### 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).

## Sign-In Issues

Expand Down Expand Up @@ -58,14 +61,10 @@ Another common issue during sign-in is not receiving a verification code when us
- Use this code in SideStore to complete the sign-in process.


## Can't Refresh or Install Apps
## My apps disappeared from SideStore and I don't know what to do!

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.

### Resolving No Wi-Fi or VPN Error
## Cannot start DebugServer

1. Enable Airplane Mode and 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:
- Turn off any DNS servers blocking domains such as `ocsp.apple.com`
- Disconnect from school/work Wi-Fi and connect to a restriction-free network.
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. [Reimport your pairing file using iloader](../advanced/pairing-file).
There are times when the DebugServer doesn't work. However, you can try [replacing your pairing file using iloader](advanced/pairing-file).