1. Installing LiveContainer

1.1. LiveContainer won't open on iOS 18.2+

You must upgrade to LiveContainer 3.0.0+ to resolve this issue. If it still crashes, reboot your device.

1.2. The executable was signed with invalid entitlements

SideStore 0.6.0+/AltStore 2.0+ is required to install LiveContainer 3.2.58. Please consider upgrading.

2. JIT-Less Mode Setup

Please read the instruction about setting up JIT-Less mode carefully before submitting any issues about this.

2.1. (SparseStore)Wrong SideStore Opened / SideStore is no Longer Available

1. Patch SideStore -> Archive Only
2. Patched SideStore is saved in LiveContainer's documents folder, you can see it in the "Files" app. Sideload it in the right SideStore to apply the patch.

3. Signing / App Installation Related

3.1. The App is Signed with Latest Certificate but its Code Signature is Invalid or A wall of error including "Signature Invalid"

Please perform a test in LiveContainer settings -> Test JIT-Less Mode before submitting any issues about this.
Probably caused by certificate used to sign the app being revoked before expires.
Solution: Long press app -> Settings -> scroll down -> force re-sign

If this does not help, please check JIT-Less diagnose page and see if your certificate is revoked. If so, first reimport your certificate. If it still does not work, you probably need to refresh your store.

4. App Crash

4.1. could not register fairplay decryption, mremap_encrypted() => -1

The app is not decrypted. Please find a decrypted ipa.

4.2. App returned from its main function with code 0

The ipa is in an invalid format, please find another one. If you try to sideload this ipa in SideStore/AltStore, it will report a "This app is in an invalid format." error.

4.3. App show a black screen and crash after 10s

The black screen fix is not automatically applied after 3.1.55. You can enable it by: Long press app -> Settings -> Enable "Black Screen Fix"

4.4. App still crashes

For other apps, please:

1. Search through issues and see if there's a solution.
2. Directly sideload the app in SideStore/AltStore and see if it works in Sideloading environment. If not, then please find another working ipa.

If you can't find a solution, feel free to submit a compatibility issue. Please make sure to include:

1. App's exact name, please don't only say "app crashing" or "app made in X not working"
2. Find crash report in iOS settings -> Privacy & Security -> Analytics & Improvements -> Analytics Data -> Search LiveContainer
3. If the app is an open-source app please leave a link to its repo
4. The exact build of LiveContainer, i.e. not "3.1.0" only, but "3.1.0 c586e79". You can find that at the bottom of LiveContainer settings tab.

Unfortunately, due to the fact that most apps are close-source, it's super hard for us to pinpoint the issue, so no eta.

5. Using Guest Apps

5.1. Why don't apps show up in the second LiveContainer?

You need to convert app to Shared App.
Long press app -> Settings -> Convert to Shared App

5.2. How can I open one app in both LiveContainers? / How can I use the multi-account feature?

1. Create a new data folder: Long press app -> Settings -> Containers -> New data folder
2. Long press app -> Settings -> Select a container -> Run

5.3. How can I open a link/webpage/url in a guest app?

You can share a web page to LiveContainer using this shortcut. Be sure to add this shortcut to "Favorites" in share sheet actions.

5.4. Can't select file / File picker not working / App can't proceed without enabling notification

Long press app -> Settings -> Enable "Fix File Picker & Local Notification"

5.5. How to modify app settings that are supposed to be in iOS settings

Long press app -> Settings -> (container name) -> Container Preferences

5.6. "Safari cannot open this page because the address is invalid" when signing in through Safari

Please refer to this issue: #242.

5.7. How can I use widgets/plugins etc.?

No, you can't. They require extra app ids. You can integrate the plugin with LiveContainer if you really want to use that plugin, but doing so will cost 1 app id.

5.8 How can I enable JIT for guest apps?

LiveContainer has built-in support for popular JIT enablers. You can set it up in LiveContainer settings -> JIT section.
Mark an app as JIT needed by going to: long press app -> settings -> enable Launch with JIT. LiveContainer will wait for JIT to be enabled and try to contact the JIT enabler you configured.

For StikDebug (Recommended), Choose "StikDebug".

ForSideStore, choose SideStore as your JIT enabler. Please note that since SideStore's JIT URL Scheme is not implemented yet, you still need to manually enable JIT for current LiveContainer in SideStore.

For JitStreamer-EB (Deprecated), choose JitStreamer-EB as your JIT enabler. If you use JitStreamer through a Wireguard VPN and you use the official server or you self-host and did not changed the WIREGUARD_SERVER_ADDRESS variable, you can leave "Address" blank. Otherwise, put the address to your server in "Address", including scheme (http/https) and port (9172).

For SideJITServer/JITStreamer 2.0, please input both your address and device UDID.

The correct way to enable JIT for an app inside LiveContainer

0. Don't enable JIT for LiveContainer now
1. Set up your JIT enabler as said above
2. Enable "Launch with JIT" as said above
3. Tap run
4. If your JIT enabler doesn't support automatic enabling, you need to enable JIT for LiveContainer from your JIT enabler while keeping the "waiting for JIT" prompt open.