Skip to content

Commit 28c7080

Browse files
committed
docs: rewrite JIT-Less setup diagnose faq
1 parent 514e384 commit 28c7080

2 files changed

Lines changed: 48 additions & 47 deletions

File tree

docs/faq/jit-less-mode-setup.md

Lines changed: 46 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -5,47 +5,64 @@ sidebar_position: 6
55

66
# JIT-Less Setup & Diagnose
77

8-
Use this page when certificate import fails or diagnose fields are not healthy.
8+
Use this page when `Settings -> JIT-Less Mode Diagnose` shows red values or `Test JIT-Less Mode` fails.
99

10-
## Healthy diagnose state
11-
12-
In `Settings -> JIT-Less Mode Diagnose`, target values are:
10+
Healthy state:
1311

12+
- `App Group ID` is not `Unknown`
1413
- `App Group Accessible = Yes`
15-
- `Store` correctly detected
16-
- `Patch Detected = Yes`
17-
- `Certificate Data = Yes`
18-
- `Password Found = Yes`
19-
- `Certificate Last Update` refreshes after reopening store app
14+
- `Store` matches your real install source (not `Unknown`)
15+
- `Certificate Data Found = Yes`
16+
- `Certificate Password Found = Yes`
17+
- `Certificate Status = Valid`
18+
- `Certificate Team ID` matches `Expected Team ID`
19+
- `Certificate Last Update Date` is not `Unknown`
20+
21+
## `App Group ID = Unknown` / `App Group Accessible = No` / `Store = Unknown`
22+
23+
Causes:
24+
25+
- Entitlements were broken.
26+
- LiveContainer was not installed through AltStore/SideStore or Impactor.
27+
- LiveContainer and Store are signed with different Apple accounts (Team ID mismatch).
28+
29+
Fixes:
30+
31+
1. Ensure LiveContainer and AltStore/SideStore are signed with the same Apple account.
32+
2. Reinstall LiveContainer via AltStore/SideStore and keep required extensions/entitlements (`Use Main Profile` / `Keep All Extensions`).
33+
3. In Diagnose -> `Entitlement File`, verify: `get-task-allow = Yes`, `application-groups Correct = Yes`, and `keychain-access-groups Correct = Yes`.
34+
35+
## `Certificate Data Found = No` / `Certificate Password Found = No` / `Certificate Last Update Date = Unknown`
36+
37+
Causes:
38+
39+
- Certificate import was not completed.
2040

21-
## App Group inaccessible or Store is `Unknown`
41+
Fixes:
2242

23-
Checklist:
43+
1. Re-import the certificate in `Settings` (file import or import from Store).
44+
2. Refresh Diagnose.
2445

25-
1. SideStore installed through AltServer.
26-
2. LiveContainer installed directly through AltStore/SideStore.
27-
3. Same Apple account used for SideStore and LiveContainer.
28-
4. Entitlements were preserved by your install/sign flow.
46+
## `Certificate Team ID` does not match `Expected Team ID` (red)
2947

30-
If still broken, inspect `Entitlement File` in diagnose page and verify `com.apple.security.application-groups` exists and looks correct.
48+
Causes:
3149

32-
## Patch Detected is `No`
50+
- Imported `.p12` belongs to a different Apple Developer Team.
3351

34-
1. Force-close store app.
35-
2. Reopen store app.
36-
3. Return to LiveContainer and refresh diagnose page.
37-
4. If still `No`, patch store again.
52+
Fixes:
3853

39-
## SideStore crashes after patching
54+
1. Remove current certificate data.
55+
2. Re-import a certificate that matches the current LiveContainer signing account.
4056

41-
Reinstall SideStore with the recommended order, then repatch only after base install is stable.
57+
## `Certificate Status = Revoked/Unknown` / `Certificate Validate Until = Unknown` / `Test JIT-Less Mode` fails
4258

43-
## Wrong SideStore instance opened (SparseStore mismatch)
59+
Causes:
4460

45-
1. Patch with `Archive Only`.
46-
2. Get patched IPA from LiveContainer documents in Files.
47-
3. Install that patched IPA into the intended SideStore instance.
61+
- Certificate is revoked/expired.
4862

49-
## Cert import worked before but now fails
63+
Fixes:
5064

51-
If AltStore/SideStore was reinstalled via AltServer, re-import certificate in LiveContainer. Old references can become stale.
65+
1. Re-import a valid certificate and ensure password is correct.
66+
2. Reopen Store and refresh apps, then return and refresh Diagnose.
67+
3. Run `Test JIT-Less Mode` again.
68+
4. If it still fails, reinstall or re-patch Store.

docs/guides/jit-less-diagnose-page.md

Lines changed: 2 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,9 @@
11
---
2-
title: JIT-Less
2+
title: JIT-Less Diagnose Page
33
sidebar_position: 9
44
---
55

6-
# JIT-Less
7-
8-
If you are using the bundled SideStore build, complete the setup in [LiveContainer + SideStore: Setup after Installing](/docs/installation/lc_sidestore#setup-after-installing) first.
9-
If you are using standalone LiveContainer, follow [Standalone LiveContainer: JIT-Less mode setup](/docs/installation/standalone#jit-less-mode-without-jit-recommended).
10-
11-
## JIT-Less actions in Settings
12-
13-
Open `Settings` in LiveContainer and find the `JIT-Less` section.
14-
15-
- `Import Certificate`: Import a `.p12` certificate file and password manually from Files.
16-
- `Import Certificate from SideStore`: Ask your store app to export certificate data to LiveContainer.
17-
- `Refresh Certificate from SideStore`: Re-import certificate data from your store and overwrite the current one.
18-
- `Remove Certificate`: Remove imported certificate data/password from LiveContainer.
19-
- `JIT-Less Diagnose`: Open the diagnosis page to verify entitlement access and certificate state.
20-
21-
On the bundled SideStore build, this refresh can read the certificate directly from the built-in SideStore after confirmation.
22-
Use `Refresh Certificate from AltStore/SideStore` after you reinstall, re-login, or refresh your store environment, especially if certificate-related checks become stale or fail.
6+
# JIT-Less Diagnose Page
237

248
<img width="300" alt="JIT-Less Diagnose Page" src="/img/jit-less-diagnose/1.png" />
259

0 commit comments

Comments
 (0)