Install · iOS
Install on iOS
The official install guide supports AltStore or iloader for sideloading. This page focuses on the AltStore path; for iloader, follow twilitrealm.dev/install.
You need a supported GameCube dump (see Setup) and the latest Dusklight-vX.X.X-ios-arm64.ipa from Download by system or Releases.
Prerequisites
- A Mac with Homebrew (for AltServer).
- iPhone connected over USB for first-time AltStore install.
- The Dusklight
.ipaand your verified game dump accessible from the Mac.
Another version?
The home page lists the latest build per OS. For an older tag, filename patterns, or to-grab a package by hand, read Releases first, then use the button below only when you need the raw Assets list.
Open full download listAltStore path (recommended)
Steps align with the project's iOS install guide (AltStore workflow).
On the Mac, install and start AltServer:
brew install altserverthen open AltServer — it should appear in the menu bar.On the iPhone (iOS 16+), enable Developer Mode: Settings → Privacy & Security → Developer Mode, turn it on, and restart when prompted.
In AltServer's menu bar icon, choose Install AltStore and select your iPhone. Sign in with your Apple ID if asked. On the phone, open Settings → General → VPN & Device Management, trust your Apple ID under Developer App.
Copy the
.ipaand your disc image onto the iPhone so both appear in the Files app — AirDrop, iCloud Drive, Finder over USB, or cloud download are all typical.Open AltStore on the iPhone → My Apps → tap +, pick the Dusklight
.ipafrom Files, and let installation finish.Launch Dusklight, then continue with Setup: Select Disc Image to your verified dump, then Play.
Community tips may appear in threads such as this Reddit discussion. For engine issues after a successful install, use FAQ or GitHub Issues.