> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobster.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# mobster wifi

> Use an iPhone without the cable, over the encrypted Wi-Fi link.

Turn on Wi-Fi use for an iPhone you set up with a cable once, see how each phone is connected, and check the encrypted link between this Mac and the phone.

## Usage

```text theme={"theme":"css-variables"}
mobster wifi <command>
```

```text theme={"theme":"css-variables"}
examples:
  mobster wifi status
  mobster wifi on --device "Sam's iPhone"
  mobster wifi probe --device "Sam's iPhone"
```

## Commands

| Command | What it does |
| - | - |
| [`mobster wifi status`](#mobster-wifi-status) | show how each iPhone is connected, and whether Wi-Fi is on for it |
| [`mobster wifi on`](#mobster-wifi-on) | let an iPhone be used over Wi-Fi (plug it in first) |
| [`mobster wifi off`](#mobster-wifi-off) | use an iPhone only with the cable again |
| [`mobster wifi probe`](#mobster-wifi-probe) | check the encrypted Wi-Fi link to an unplugged iPhone, step by step |

## `mobster wifi status`

Show each iPhone set up here: on the cable, on Wi-Fi, or not reachable, and whether Wi-Fi is on for it. Reads only; changes nothing.

### Options

| Name | Default | Description |
| - | - | - |
| `--json` | off | print one JSON object |

## `mobster wifi on`

Let Mobster reach an iPhone over Wi-Fi when it's unplugged, through the encrypted link between this Mac and the phone. The iPhone must be plugged in and trust this Mac; this is the same switch as Connect via network in Xcode.

### Options

| Name | Default | Description |
| - | - | - |
| `--device NAME` | your iPhone | the iPhone: an id, UDID or name from `mobster devices` |
| `--json` | off | print one JSON object |

```text theme={"theme":"css-variables"}
exit codes: 0 on, 1 it couldn't be turned on, 2 usage, 3 no such iPhone
```

## `mobster wifi off`

Stop using an iPhone over Wi-Fi. When Mobster turned on the iPhone's own switch (Connect via network), it turns that off too, over the cable. When it can't, or Xcode turned the switch on, it says what to do.

### Options

| Name | Default | Description |
| - | - | - |
| `--device NAME` | your iPhone | the iPhone: an id, UDID or name from `mobster devices` |
| `--json` | off | print one JSON object |

```text theme={"theme":"css-variables"}
exit codes: 0 off, 1 it failed or the iPhone's own switch is still on (plug it in and run this again), 2 usage, 3 no such iPhone
```

## `mobster wifi probe`

Check an unplugged iPhone over Wi-Fi: what Xcode's device service reports, the encrypted tunnel, WebDriverAgent on the tunnel through this Mac's relay, and that the phone's Wi-Fi address does not answer on 8100 or 9100. It binds only 127.0.0.1 and changes nothing on the phone (with `--start`, it launches the helper app on it for the probe, then stops it).

### Options

| Name | Default | Description |
| - | - | - |
| `--device NAME` | your iPhone | the iPhone: an id, UDID or name from `mobster devices` |
| `--start` | off | launch the helper app over Wi-Fi for the probe when it isn't running (quit the Mac app first) |
| `--json` | off | print one JSON object |

```text theme={"theme":"css-variables"}
exit codes: 0 every check passed, 1 a check failed, 2 usage, 3 couldn't run
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.