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

# Install Polymorfa Inspector

> Install the desktop testing surface for the Polymorfa sandbox.

Polymorfa Inspector is the desktop testing surface for WhatsApp integrations. It runs WhatsApp Web against the Polymorfa test cluster and works with the [Sandbox](/sandbox/introduction).

## Download

Open [polymorfa.com/sandbox/install](https://polymorfa.com/sandbox/install). The page reads the signed release manifest and offers only the current fixed artifacts:

| Platform | Architecture | Artifact                            |
| -------- | ------------ | ----------------------------------- |
| macOS    | Universal    | `Polymorfa-Inspector-universal.dmg` |
| Windows  | x64          | `Polymorfa-Inspector-x64.exe`       |
| Linux    | x64          | `Polymorfa-Inspector-x64.AppImage`  |

Every download has a `SHA256SUMS` sidecar. If the manifest cannot be fetched or validated, the install page shows downloads as temporarily unavailable instead of guessing a release URL.

## Verify and install

<Tabs>
  <Tab title="macOS">
    Compare the downloaded file's SHA-256 digest with its sidecar, open the DMG, and drag **Polymorfa Inspector** into Applications.

    ```bash theme={null}
    shasum -a 256 Polymorfa-Inspector-universal.dmg
    ```
  </Tab>

  <Tab title="Windows">
    Compare the digest, then run the installer.

    ```powershell theme={null}
    Get-FileHash .\Polymorfa-Inspector-x64.exe -Algorithm SHA256
    ```
  </Tab>

  <Tab title="Linux">
    Compare the digest, mark the AppImage executable, and launch it.

    ```bash theme={null}
    sha256sum Polymorfa-Inspector-x64.AppImage
    chmod +x Polymorfa-Inspector-x64.AppImage
    ./Polymorfa-Inspector-x64.AppImage
    ```
  </Tab>
</Tabs>

Use the Inspector install page to download the current release. Verify the
download against the checksum in the latest release manifest before opening it.

## Authorize Inspector

Inspector displays an eight-character device code. Open the browser device
page and complete these checks:

1. Confirm the signed-in account, or choose **Use a different account**.
2. Choose the organization Inspector should access. When only one organization
   is available, Polymorfa selects it automatically.
3. Enter the code shown by Inspector.
4. Review the requesting app, request time, available city and IP information,
   selected organization, and active projects.
5. Choose **Authorize Inspector** or **Deny request**.

Codes are normalized to uppercase letters and digits and cannot be reused after
denial, expiry, or a completed decision. Approval creates an Inspector session
for the selected organization without exposing the browser session. You can
review or revoke that access under **Account settings → Authentication → Active
sessions** in the Console.

<Warning>
  Approve only when the code exactly matches Inspector. A device code is
  temporary authorization material; do not send it through chat or support.
</Warning>

## Where to go next

<Columns cols={2}>
  <Card title="Sandbox quickstart" icon="flask" href="/sandbox/quickstart">
    Create and manage a testing number.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/desktop-app/troubleshooting">
    Diagnose Inspector and connection issues.
  </Card>
</Columns>