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

# Quickstart

> Inspect your backend requests with just one command

Subtrace is the network inspector for your backend. With just one command, you'll be able to see every HTTP request in your backend.

Follow this guide to add it to your codebase in under two minutes.

<Steps>
  <Step title="Install the Subtrace CLI">
    Open a terminal and install the Subtrace CLI:

    ```bash theme={null}
    curl -fsSL https://subtrace.dev/install.sh | sh
    ```
  </Step>

  <Step title="Start with Subtrace">
    Start your backend like you normally do but wrap the command with Subtrace:

    <CodeGroup>
      ```bash Generic theme={null}
      subtrace run -- my-app-command
      ```

      ```bash Node theme={null}
      subtrace run -- node server.js
      ```

      ```bash Go theme={null}
      subtrace run -- go run .
      ```

      ```bash FastAPI theme={null}
      subtrace run -- fastapi run main.py
      ```

      ```bash Flask theme={null}
      subtrace run -- flask --app hello run
      ```

      ```bash Gunicorn theme={null}
      subtrace run -- gunicorn -w 4 myapp:app
      ```

      ```bash Laravel theme={null}
      subtrace run -- php artisan serve
      ```
    </CodeGroup>

    <Expandable title="example output">
      <img className="rounded-xl" src="https://mintcdn.com/subtrace/qpTd5I2XwvFUV3U2/images/quickstart-link.png?fit=max&auto=format&n=qpTd5I2XwvFUV3U2&q=85&s=28474cf12fde51150c7dff880eadf80c" width="892" height="494" data-path="images/quickstart-link.png" />
    </Expandable>
  </Step>

  <Step title="Watch">
    Open the `subt.link` URL in your browser to watch a live stream of your
    backend server's network logs!

    <img className="rounded-xl" src="https://mintcdn.com/subtrace/qpTd5I2XwvFUV3U2/images/quickstart-screenshot.png?fit=max&auto=format&n=qpTd5I2XwvFUV3U2&q=85&s=872ff44cbd35bdeb2d0650809e982ea5" width="2254" height="1640" data-path="images/quickstart-screenshot.png" />
  </Step>
</Steps>

## Next steps

Check out the guide specific to your backend for next steps:

* **Node**: [Express.js](/nodejs-express)
* **Python**: [FastAPI](/python-fastapi), [Flask](/python-flask), [Gunicorn](/python-gunicorn)
* **Others**: [Go](/golang), [Laravel](/php-laravel)

If your language or framework isn't listed here, let us know and we can help
you get started. Join our [discord server](https://subtrace.dev/discord) or
email us at [support@subtrace.dev](support@subtrace.dev) for assistance.

## Troubleshooting

<AccordionGroup>
  <Accordion title="error: subtrace: missing SYS_PTRACE capability">
    Add the `SYS_PTRACE` capability to your container.

    <CodeGroup>
      ```bash Docker (docker run) theme={null}
      docker run --cap-add=SYS_PTRACE ...
      ```

      ```yaml Docker Compose theme={null}
      services:
        my-app:
          cap_add:
            - SYS_PTRACE
      ```
    </CodeGroup>

    See the [full guide](/ptrace) for other platforms and environments.
  </Accordion>
</AccordionGroup>