# Find fleetctl and run doctor

Find the CLI inside the app you actually installed, then inspect installation and controller diagnostics. This procedure does not install, restart or stop the controller. Start with an existing supported Fleet Console bundle and permission to inspect your local installation.

## Use the bundled path

If the app is in Applications, run:

```bash
"/Applications/FleetConsole.app/Contents/Resources/bin/fleetctl" --help
"/Applications/FleetConsole.app/Contents/Resources/bin/fleetctl" doctor
```

If it is installed elsewhere, substitute the actual bundle path in both commands. Quoting matters because a path can contain spaces. Do not assume a similarly named command found on PATH belongs to the app you are investigating.

## Read the diagnostics

Help describes the CLI's command surface. Doctor checks controller connectivity and local installation state; it is not a repair command. Its documented checks include the socket, launchd job, controller response, supervisor/reconciler activity, registry, configuration and log directory. Some checks report informational conditions rather than faults.

A responding controller does not prove every service is healthy. Conversely, a controller connection failure does not prove existing processes have stopped. Preserve their identities and do not launch replacement copies merely because diagnostics could not contact the controller.

## Check your result

You should know which bundle supplied the CLI, whether help could run and which doctor checks were available or failed. Record the exact non-secret error rather than summarizing every failure as “not installed.” If the command path does not exist, inspect the actual app location before changing PATH or downloading another copy.

For support, redact user paths, process commands and account material from diagnostic output. Continue with [data and log locations](/docs/fleet-console/configuration-registry-and-log-locations) and [shared support](/docs/shared/support). The [maintained CLI guide](https://github.com/janestreetshiller/fleet-console/blob/87c38aff663db2e0c70e90eea5c8781ceb32a1e4/docs/CLI.md) documents doctor as an inspection operation.