> ## 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 doctor

> Check your iPhone, key and tools; --fix fixes what it can.

Check everything a task needs and print how to fix what is missing. Without `--fix` it changes nothing. Keys are shown masked: their first characters and last four.

`--fix` does the fix each finding carries, then checks again and prints what it did and what it could not do. It starts the helper app, or refreshes one that expired, on its own, and leaves it to Mobster for Mac when that is running. It names a program that holds a port, or a service that doesn't answer, and asks before it stops it. It hands over to `mobster login` and `mobster setup` for what needs your answers. It never enters a passcode, runs sudo or downloads a runtime. Without a terminal, or with `--json`, it skips every question and says which.

## Usage

```text theme={"theme":"css-variables"}
mobster doctor [options]
```

## Options

| Name | Default | Description |
| - | - | - |
| `--wda-url URL` | [http://127.0.0.1:8100](http://127.0.0.1:8100) | the phone's address, for a phone you set up by hand \[env: MOBSTER\_WDA\_URL] |
| `--device NAME` | your iPhone | the iPhone or simulator to use: an id, UDID or name from `mobster devices` |
| `--env-file PATH` | none | load KEY=VALUE lines (ANTHROPIC\_API\_KEY, OPENAI\_API\_KEY, ...); variables already set win \[env: MOBSTER\_ENV\_FILE] |
| `--fix` | off | do the fix each finding carries, then check again |
| `--json` | off | print the checks as JSON |
| `--simulator` | off | skip the USB iPhone and Xcode checks (a simulator's phone) |

```text theme={"theme":"css-variables"}
exit codes: 0 ready for tasks (warnings allowed), 1 at least one problem

examples:
  mobster doctor
  mobster doctor --fix
```


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