---
title: native doctor
url: "https://native-sdk.dev/docs/debugging/doctor"
docs_index: /llms.txt
lastUpdated: 2026-10-16
---

> For an index of all documentation, see [/llms.txt](/llms.txt).

The `native doctor` command checks your development environment for issues.

## What it checks

<table>
  <thead>
    <tr>
      <th>
        Check
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Host platform
      </td>

      <td>
        Operating system and architecture
      </td>
    </tr>

    <tr>
      <td>
        WebView
      </td>

      <td>
        WKWebView (macOS) or WebKitGTK (Linux) availability
      </td>
    </tr>

    <tr>
      <td>
        Manifest
      </td>

      <td>
        `app.json`

        or

        `app.zon`

        validation when a manifest is discovered or passed explicitly
      </td>
    </tr>

    <tr>
      <td>
        Log directory
      </td>

      <td>
        Writability of the log output path
      </td>
    </tr>

    <tr>
      <td>
        CEF
      </td>

      <td>
        CEF distribution presence when Chromium is selected by the app manifest or

        `--web-engine chromium`
      </td>
    </tr>

    <tr>
      <td>
        Signing tools
      </td>

      <td>
        Code signing tool availability
      </td>
    </tr>
  </tbody>
</table>

## Usage

```bash
# Informational (always exits 0)
native doctor

# Strict mode (exits non-zero on any warning)
native doctor --manifest app.json --strict

# Check CEF setup
native doctor --manifest app.json
```

## Flags

<table>
  <thead>
    <tr>
      <th>
        Flag
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `--strict`
      </td>

      <td>
        Exit non-zero on any warning
      </td>
    </tr>

    <tr>
      <td>
        `--manifest`
      </td>

      <td>
        Path to

        `app.json`

        or

        `app.zon`
      </td>
    </tr>

    <tr>
      <td>
        `--web-engine`
      </td>

      <td>
        Temporarily override the engine from the app manifest with

        `system`

        or

        `chromium`
      </td>
    </tr>

    <tr>
      <td>
        `--cef-dir`
      </td>

      <td>
        Temporarily override the CEF distribution path
      </td>
    </tr>

    <tr>
      <td>
        `--cef-auto-install`
      </td>

      <td>
        Temporarily allow automatic prepared CEF installation for Chromium checks
      </td>
    </tr>
  </tbody>
</table>

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)