iOS Revival server guide

How Exvius Revival for iOS works

Because iOS does not run Android APK files, CreamySeaman6/Exvius-revival-ios wraps the Elvlin/exvius-offline game engine inside a self-hosted Docker Compose container alongside Tailscale. Your iPhone runs the unmodified App Store version of Final Fantasy Brave Exvius Global (tested on Global build 1167 / ver.9100 on iOS) and talks to your server over a private Tailscale split-DNS route:

• Requirements: an Apple account that previously downloaded FFBE Global (re-downloadable from App Store → your account → Purchased), a Windows/macOS/Linux PC or NAS running Docker with 17 GB of free disk space during setup (15 GB after), and a free Tailscale account.
• Isolated network & X.509 name constraint: the container joins your tailnet as a machine named ffbe with its own 100.x.y.z IP. Its DNS responder answers only gumi.sg and exvius.com, and its private root certificate carries a strict X.509 name constraint so it can only vouch for those two domains.

Step-by-step Docker & iPhone setup

1. Clone the repository on your computer: install Docker Desktop (or Docker Engine + Compose on Linux/NAS) and run:

   mkdir exvius && cd exvius
   git clone https://github.com/CreamySeaman6/Exvius-revival-ios.git repo
   cd repo/ios-server
   cp .env.example .env

2. Add your Tailscale auth key: in the Tailscale admin console, go to Settings → Keys → Generate auth key (leave reusable and ephemeral off), paste it after TS_AUTHKEY= in .env, and save.
3. Build & download the 14.6 GB game data:

   docker compose build
   docker compose run --rm server fetch-data
   docker compose up -d
   docker compose logs -f server

   Wait for the log line ending in http://100.x.y.z/ca.mobileconfig, write down that 100.x.y.z address, and press Ctrl+C.
4. Configure Tailscale split DNS: in the Tailscale admin console, open Machines → ffbe → … → Disable key expiry. Then open DNS → Nameservers → Add nameserver → Custom, enter your 100.x.y.z IP, turn on Restrict to domain for gumi.sg, and save. Add a second restricted nameserver entry with the same IP for exvius.com.
5. Trust the certificate on your iPhone: connect the Tailscale iOS app, install FFBE from App Store → Purchased, and open http://100.x.y.z/ca.mobileconfig in Safari. Install the profile in Settings → Profile Downloaded, then go to Settings → General → About → Certificate Trust Settings and turn on Exvius Offline Root.
6. Verify & launch twice: open https://v900-lapis.gumi.sg/__exvius/hello in Safari—if it says “Reachable. You can open the game.”, launch FFBE and let it finish its initial download. After logging in once, swipe the game closed in the iOS app switcher and reopen it so the patched upfront download list loads before your first battle.

How the server fixes stock iOS client bugs

The preserved assets come from Android, so source/server/ patches several iOS incompatibilities on the fly:

• MST_LOAD_FAILURE fix: offsets every table version by +200000 (EXVIUS_TABLE_VERSION_OFFSET) so the iPhone replaces its bundled tables, and converts Windows CRLF line endings to LF.
• CRI HCA audio decryption (sound_compat.py): Android sound banks use CRI HCA cipher type 1, which plays as loud static on iOS. With EXVIUS_IOS_HCA_PLAIN=1, the server strips the cipher and rewrites frame checksums as it serves audio to /ios/ paths.
• Vortex banner CPK rebuild (ios_art.py): packs loose event PNGs into a ~240 MB Vortex banner archive cached in FFBE_DIR/server/ios-cache/ so Vortex tiles show artwork and the Enhance tab does not crash.
• Missing English strings (ios_texts.py): injects English bundle and ticket names into the game’s text tables so the stock iOS client never displays raw MST_BUNDLE_NAME_* keys.

Key docker-compose.yml settings & Historical Replay

Edit these variables in docker-compose.yml (or your Unraid template) and run docker compose up -d:

iOS server log diagnostics