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

# Quick start

> Start intercepting HTTP traffic in 4 steps

Get httpmon running and capturing traffic in under a minute.

<Steps>
  <Step title="Install httpmon">
    Install with Homebrew (macOS/Linux) or see [all installation options](/installation).

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    brew install kostyay/tap/httpmon
    ```
  </Step>

  <Step title="Start httpmon and browse">
    The fastest way to start is with `--browse` — it configures the system proxy and opens the URL in your default browser automatically.

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    httpmon --browse https://httpbin.org/get
    ```

    The CA certificate is installed automatically if needed (may prompt for sudo). Proxy settings are restored when httpmon exits.

    <Accordion title="Manual setup (without --browse)">
      Launch the proxy and configure your browser or application manually.

      ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
      httpmon
      ```

      Set your browser to use `http://localhost:8080` as its HTTP proxy, or use environment variables for CLI tools:

      ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
      export http_proxy=http://localhost:8080
      export https_proxy=http://localhost:8080
      ```
    </Accordion>
  </Step>

  <Step title="Inspect traffic">
    Flows appear in the TUI as they arrive. Use `j` and `k` to navigate the flow list. Press `Enter` to open the detail inspector for any flow.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/pragmaticoslu/GKMvH6x25ZdEJHbo/images/screenshots/quickstart.png?fit=max&auto=format&n=GKMvH6x25ZdEJHbo&q=85&s=300f39ada03ab51ff66419734af4bee8" alt="httpmon first flow" width="5877" height="1904" data-path="images/screenshots/quickstart.png" />
</Frame>

## Enable HTTPS interception

By default, httpmon only intercepts plain HTTP traffic. To intercept HTTPS, you need to trust the httpmon CA certificate.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sudo httpmon --install-ca
```

This generates a CA certificate (if one does not exist yet) and adds it to your system trust store. See [CA certificate setup](/ca-setup) for manual installation steps and browser-specific instructions.