The Run WDA program cannot be launched on iOS 17.2

[TestLoong]

1、PC：Windows 10 Professional Workstation Edition（19044.1466）
2、go-ios version：[v1.0.192]

PS C:\Users\xxxxxxxxxx> ios tunnel start
{"level":"warning","msg":"go-ios agent is not running. You might need to start it with 'ios tunnel start' for ios17+. Use ENABLE_GO_IOS_AGENT=user for userspace tunnel or ENABLE_GO_IOS_AGENT=kernel for kernel tunnel for the experimental daemon mode.","time":"2026-01-14T17:57:10+08:00"}
{"level":"info","msg":"no udid specified using first device in list","time":"2026-01-14T17:57:10+08:00","udid":"00001111-000055661H63U12P"}
{"level":"info","msg":"Tunnel server started","time":"2026-01-14T17:57:10+08:00"}
{"level":"info","msg":"start tunnel","time":"2026-01-14T17:57:11+08:00","udid":"00001111-000055661H63U12P"}
{"level":"info","msg":"ManualPairAndConnectToTunnel: starting manual pairing and tunnel connection, dont forget to stop remoted first with 'sudo pkill -SIGSTOP remoted' and run this with sudo.","time":"2026-01-14T17:57:11+08:00"}
{"error":"ManualPairAndConnectToTunnel: failed to find device ethernet interface: context deadline exceeded","level":"warning","msg":"failed to start tunnel","time":"2026-01-14T17:57:21+08:00","udid":"00001111-000055661H63U12P"}
{"level":"info","msg":"start tunnel","time":"2026-01-14T17:57:21+08:00","udid":"00001111-000055661H63U12P"}

PS C:\Users\XXXXXX01> ios list
{"deviceList":["00001111-000055661H63U12P"]}
PS C:\Users\XXXXXX01> ios runwda --udid=00001111-000055661H63U12P --bundleid=com.cheyun.WebDriverAgentLib.xctrunner --testrunnerbundleid=com.cheyun.WebDriverAgentLib.xctrunner --xctestconfig=WebDriverAgentRunner.xctest
{"level":"warning","msg":"failed to get tunnel info","time":"2026-01-14T17:58:14+08:00","udid":"00001111-000055661H63U12P"}
{"bundleid":"com.cheyun.WebDriverAgentLib.xctrunner","level":"info","msg":"Running wda","testbundleid":"com.cheyun.WebDriverAgentLib.xctrunner","time":"2026-01-14T17:58:14+08:00","xctestconfig":"WebDriverAgentRunner.xctest"}
{"error":"runXUITestWithBundleIdsXcode15Ctx: cannot create a tunnel connection to testmanagerd: ConnectToServiceTunnelIface: Cannot connect to com.apple.dt.testmanagerd.remote, missing tunnel address and RSD port","level":"error","msg":"Failed running WDA","time":"2026-01-14T17:58:14+08:00"}

I haven't encountered this issue on other iOS versions, such as iOS 15.7, 18.2, and 26.2. Can you help me see what caused it?

[gmegidish]

Hey @TestLoong . I think in this specific case, you just didn't create a tunnel for this device.

Tunnels are required from iOS 17 and above. You may create a tunnel in a dedicate terminal, by running ios tunnel start --userspace. Once you have the tunnel running, you should be able to run the runwda command.

Also know, that sometimes iOS invalidates the app on the device, and you just need to reinstall it from xcode. The error message wouldn't reflect it, it would just say that connection timed out or something in that fashion.

[UMR-Haozi]

I succeeded after switching to a different device.

[TestLoong]

Hey @TestLoong . I think in this specific case, you just didn't create a tunnel for this device.

Tunnels are required from iOS 17 and above. You may create a tunnel in a dedicate terminal, by running ios tunnel start --userspace. Once you have the tunnel running, you should be able to run the runwda command.

Also know, that sometimes iOS invalidates the app on the device, and you just need to reinstall it from xcode. The error message wouldn't reflect it, it would just say that connection timed out or something in that fashion.

Hey @TestLoong . I think in this specific case, you just didn't create a tunnel for this device.

Tunnels are required from iOS 17 and above. You may create a tunnel in a dedicate terminal, by running ios tunnel start --userspace. Once you have the tunnel running, you should be able to run the runwda command.

Also know, that sometimes iOS invalidates the app on the device, and you just need to reinstall it from xcode. The error message wouldn't reflect it, it would just say that connection timed out or something in that fashion.

hi, I encountered this issue again, this time on another iPhone with the system version: 26.3. Symptoms: After launching WDA the previous day and disconnecting the USB cable at night, an error occurs when reconnecting the next day. This happens frequently and irregularly.

ios runwda --udid=00008030-666666666E2B802E --bundleid=com.test.WebDriverAgentLib.xctrunner --testrunnerbundleid=com.test.WebDriverAgentLib.xctrunner --xctestconfig=WebDriverAgentRunner.xctest {"bundleid":"com.test.WebDriverAgentLib.xctrunner","level":"info","msg":"Running wda","testbundleid":"com.test.WebDriverAgentLib.xctrunner","time":"2026-04-03T09:14:31+08:00","xctestconfig":"WebDriverAgentRunner.xctest"} {"error":"runXUITestWithBundleIdsXcode15Ctx: cannot create a tunnel connection to testmanagerd: ConnectToServiceTunnelIface: failed to connect to tunnel: ConnectToHttp2WithAddr: failed to dial: dial tcp [fd9e:9ded:491c::1]:0: connectex: The requested address is not valid in its context.","level":"error","msg":"Failed running WDA","time":"2026-04-03T09:14:31+08:00"}

[danielpaulus]

Two separate things landed in this thread. The original failure: on Windows the default kernel tunnel needs admin rights plus wintun, so ManualPairAndConnectToTunnel failed — ios tunnel start --userspace is the right invocation, as gmegidish said. The later dial tcp [fd...]:0 after an overnight USB disconnect is the stale-tunnel problem tracked in #641; #809 (open) makes the agent detect and recreate dead tunnels, and ios tunnel refresh --udid=<udid> is the workaround today. Closing this one — follow #641 for the reconnect fix.

(part of an automated backlog sweep — comment or reopen if this got it wrong)