## Further information

See additional information how the Stripe CLI operates.

## Using with Docker

A [Docker image](https://hub.docker.com/r/stripe/stripe-cli) allows you to run the Stripe CLI in a container.

You can set two environment variables that the CLI will use:
- `STRIPE_API_KEY`: the API key to use for the CLI.
- `STRIPE_DEVICE_NAME`: the device name for the CLI, visible in the Dashboard.


Since Docker containers are ephemeral, `stripe-cli login` cannot be used without defining a data volume. You can use the `--api-key` flag instead.

### Example

```title
Running in a docker container
```

## Telemetry

The Stripe CLI includes a telemetry feature that collects usage data to help us improve the developer experience. This feature is **enabled by default**.

## What data is collected

The Stripe CLI collects:
- Command usage patterns (which commands are run, how often)
- Error rates and types to help identify issues
- Performance metrics (command execution times)
- Operating system and CLI version information
- If detected, the name of AI coding agents invoking the CLI (such as Claude Code, Cursor, or Cline)

## What is NOT collected

We do **not** collect:
- API keys or authentication credentials
- Personal information or identifiable data
- File names, paths, or source code
- Command arguments or flag values
- Any data from your Stripe account

## Why we collect this data

Telemetry data helps us:
- Prioritize which features and commands to improve
- Identify and fix bugs more quickly
- Understand how developers use the CLI in different environments
- Optimize performance for common workflows

## How to opt out

To disable telemetry, set the `STRIPE_CLI_TELEMETRY_OPTOUT` environment variable to `1` or `true`:

```bash
# Opt out for a single session
STRIPE_CLI_TELEMETRY_OPTOUT=1 stripe [command]

# Opt out permanently (add to your shell profile)
export STRIPE_CLI_TELEMETRY_OPTOUT=1
```

After opting out, the CLI will not send any telemetry data.

## License

The [Stripe CLI](https://github.com/stripe/stripe-cli) is licensed under the [Apache License 2.0](https://github.com/stripe/stripe-cli/blob/master/LICENSE) and verified on GitHub as being owned by [Stripe](https://github.com/stripe).