iPhone/iPad: install with AltStore/SideStore
Cubiq Launcher runs on iPhone and iPad too. It isn't in the App Store – you sideload it with AltStore or SideStore, which sign the app with your own Apple ID and keep it up to date from our source.
| You need | |
|---|---|
| iOS / iPadOS | 15 or newer |
| Sideloading | AltStore or SideStore (or TrollStore, if your iOS version supports it) |
| Apple ID | A free one is enough – the app then has to be refreshed every 7 days |
| Account | A Microsoft account that owns Minecraft: Java Edition |
| To play | JIT – see Enable JIT |
Install

Install AltStore or SideStore
If you don't have one yet, set up AltStore (with AltServer on a Windows PC or Mac) or SideStore (refreshes on the device itself) by following the official guide of that app. It's the hardest step – after that everything happens on the phone.
Add the Cubiq source
On your iPhone or iPad, open the download page and tap Add to AltStore or Add to SideStore. Or add it by hand: in AltStore/SideStore open Sources, tap + and paste this URL:
https://github.com/PwiePixel/Cubiq-launcher/releases/download/mobile/altstore.json
Install Cubiq Launcher
Open the source Cubiq Launcher, tap the app and then Free / Install. AltStore or SideStore signs it with your Apple ID and installs it. Keep the app open until it's done.
Open the app
Cubiq Launcher now shows up on your home screen. On iOS 16 and newer, iOS may ask you to turn on Developer Mode first (Settings → Privacy & Security → Developer Mode); the phone restarts once.
Enable JIT
Minecraft runs on Java, and Java needs JIT (just-in-time compilation) to be fast enough. iOS only allows JIT for sideloaded apps in special ways. Pick the one that fits your setup:
For iOS 17.4 and newer, completely on the device:
- Install StikDebug (for example from SideStore) and set it up once as its own guide describes (pairing file).
- Open StikDebug and choose Cubiq Launcher from the list – StikDebug starts the app with JIT enabled.
- Start your instance in Cubiq Launcher.
Do this every time you want to play; StikDebug has to be used again after the app was closed.
With AltServer on your PC or Mac on the same Wi-Fi (or connected by cable):
- Make sure AltServer is running.
- In AltStore open My Apps, press and hold Cubiq Launcher and choose Enable JIT – or use Enable JIT in AltServer's menu on the computer (AltJIT).
- Cubiq Launcher opens with JIT; start your instance.
Repeat this whenever the app was closed completely.
First start and sign-in
Language and welcome
Pick your language; the short setup works like on the PC.
Sign in with Microsoft
Tap Sign in. The app shows a short code and opens Microsoft's page. Enter the code there and sign in with the account that owns Minecraft: Java Edition. Your password only goes to Microsoft.
Play
Create an instance (Your first instance), make sure JIT is on and tap Play. The game files come from Mojang, the Cubiq Client is loaded by itself and the touch controls are the same as on Android – see Touch controls.
Notifications
Under More → Settings → Notifications you switch on notifications for chat messages, friend requests and invitations (the Cubiq online features must be on). iOS has no ntfy: the app checks in the background for new messages and shows them as notifications. iOS decides how often that happens, so notifications can come late – especially when the phone is in Low Power Mode or the app wasn't used for a while.
Updates and the 7-day limit
- Updates: when a new version is in our source, AltStore/SideStore shows an update – tap Update. Your instances and sign-in stay.
- Refresh every 7 days: apps signed with a free Apple ID stop opening after 7 days. Open AltStore or SideStore regularly and tap Refresh All (AltStore needs AltServer reachable for that, SideStore does it on the device). If the app already expired, refreshing it brings it back – nothing is lost.
- A free Apple ID allows only 3 sideloaded apps at the same time, and AltStore/SideStore counts as one of them.
Problems
The game closes right after starting
Almost always JIT is not active. Start Cubiq Launcher again through StikDebug, AltStore/AltServer or TrollStore as described above, then start the instance. If it still crashes, open the instance, go to the log and tap Share log – it uploads the log to mclo.gs with your username and secrets removed. The crash helper explains many crashes in plain words.
Minecraft 26.3 doesn't start
Minecraft 26.3 is not supported on iPhone and iPad yet. Use 26.2 or older for now.
The game runs out of memory
See the memory warning above: smaller modpacks, lower render distance, close other apps.
"Unable to Install Cubiq Launcher" – integrity could not be verified
iOS got an app without a valid signature. The usual reasons:
- AltStore PAL (EU version): it only installs apps notarised by Apple. Remove the source there and use AltStore Classic with AltServer or SideStore.
- IPA opened directly (Safari, Files) or with an app that has no certificate of its own: the IPA is unsigned on purpose – install it through AltStore/SideStore, which sign it with your Apple ID.
- Certificate reset: sign out of AltStore/SideStore in its settings, sign in again and reinstall the app.
"Unable to verify app" or the app doesn't open any more
The 7 days are over. Open AltStore/SideStore and refresh the app.
Adding the source doesn't work
Make sure you copied the full URL, including https:// and altstore.json. If the buttons on the download page do nothing, AltStore/SideStore isn't installed – add the source by hand instead.
No notifications
Allow notifications for Cubiq Launcher in iOS Settings → Notifications, keep Background App Refresh on for the app and open it now and then – iOS checks less often for apps you rarely use.
If nothing helps, report a bug and include the log link.