altstoreio / altstoreio/AltStore

Support TCP-Based JIT Activation for iOS 18.2+ (QUIC Deprecated)

Open
#1,591 0 comments 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Swift
Stars
14.4k
Forks
1.5k
PR merge metrics
No merged PRs in 30d

Description

With the release of iOS 18.2, Apple has removed support for the QUIC protocol, which breaks the current JIT activation flow used by AltJIT via the start-quic-tunnel command.

I’ve been able to manually start a TCP-based tunnel using:

python3.13 -m pymobiledevice3 remote start-tunnel

This works as expected. However, AltServer still attempts to call start-quic-tunnel, which no longer exists in the latest versions of pymobiledevice3. This leads to the following error:

Error: No such command 'start-quic-tunnel'

Request:

  • Please update AltServer / AltJIT to support TCP-based tunneling for JIT activation.
  • Ideally, allow users to manually start the tunnel and have AltServer skip tunnel setup if one is already running.
  • Alternatively, integrate TCP tunneling natively into the AltJIT process using Python 3.13+.

Environment:

  • macOS with Python 3.13
  • pymobiledevice3 v4.20.23
  • iOS 18.2+ device
  • AltServer 1.7.1

Let me know if I can help test or provide further details.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the AltServer or AltJIT entry point that invokes start-quic-tunnel, then compare its behavior with python3.13 -m pymobiledevice3 remote start-tunnel. Define the completed behavior as successful TCP-based JIT activation on iOS 18.2+ and handling for a tunnel that was started manually.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, swift
Domain
mobile-dev, networking
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.