site/docs/red-team/troubleshooting/data-handling.md
This page explains what data leaves your machine during red team testing and how to control it.
Red team testing involves three distinct operations, each with different data requirements:
| Operation | What Runs | Data Sent Externally |
|---|---|---|
| Target evaluation | Always local | Only to your configured LLM provider |
| Test generation | Local or remote | Depends on configuration (see below) |
| Result grading | Local or remote | Depends on configuration (see below) |
Your target model is always evaluated locally. Promptfoo receives target responses only when you use a hosted flow that requires them, such as remote grading or red team target discovery.
Without an OPENAI_API_KEY or a usable Codex/ChatGPT login, Promptfoo uses hosted inference for test generation and grading. The following data is sent to api.promptfoo.app:
For test generation:
purpose field)For grading:
Not sent by default during generation/grading:
Credentials, authorization headers, provider config fields, and request examples are sent if you paste them into red team target/provider setup or test forms, sharing, Cloud sync, or other Cloud-backed features. Don't enter real secrets into those flows. See the security policy for the full hosted-feature list.
Setting OPENAI_API_KEY routes generation and grading through your OpenAI account instead of Promptfoo servers:
export OPENAI_API_KEY=sk-...
Or configure a different provider for grading:
redteam:
provider: anthropic:messages:claude-sonnet-4-20250514
With this configuration, Promptfoo servers usually receive only telemetry unless you use red team target/provider setup helpers, red team target/provider test requests, sharing, Cloud sync, hosted reports, or other Cloud-backed features.
If Codex is installed and signed in with ChatGPT, Promptfoo can use openai:codex-sdk locally for default text generation and grading when no higher-priority API credentials are configured. Remote-only plugins still use hosted inference, and embedding/moderation assertions still require a provider override with API credentials.
Some plugins require Promptfoo's hosted inference and cannot run locally. These are marked with 🌐 in the plugin documentation.
Remote-only plugins include:
harmful:*)ssrf, bola, bfla, indirect-prompt-injection, ascii-smugglingcompetitors, hijacking, off-topic, system-prompt-overrideRemote-only strategies include: audio, citation, gcg, goat, jailbreak:composite, jailbreak:hydra, jailbreak:likert, jailbreak:meta
To prefer local generation:
export PROMPTFOO_DISABLE_REMOTE_GENERATION=true
This disables supported remote-generation fallbacks for red team generation paths, including red team target/provider setup helpers that rely on remote generation. It is not a network isolation guarantee and does not disable telemetry, account/license checks, sharing, Cloud sync, red team target/provider test requests, red team target/provider setup helpers that do not rely on remote generation, or explicitly configured providers. You must provide your own OPENAI_API_KEY or configure a local model for generation and grading.
For red-team-specific control (keeps SimulatedUser remote generation enabled):
export PROMPTFOO_DISABLE_REDTEAM_REMOTE_GENERATION=true
See Configuring Inference for detailed setup.
Promptfoo collects usage telemetry:
redteam generate, redteam run, etc.)Hosted telemetry may include package version, CI status, promptfoo user ID, email address, cloud login status, and authentication method when those values are present in the local promptfoo config. Prompt content, model responses, generated test cases, provider API keys, and full configuration files are not included.
To disable:
export PROMPTFOO_DISABLE_TELEMETRY=1
See Telemetry Configuration for details.
When using remote generation, Promptfoo requires access to:
| Domain | Purpose |
|---|---|
api.promptfoo.app | Test generation and grading |
api.promptfoo.dev | Consent tracking for harmful plugins |
a.promptfoo.app | Telemetry (PostHog) |
If blocked by your firewall, see Remote Generation Troubleshooting.
For organizations requiring complete network isolation:
Promptfoo Enterprise On-Prem provides:
See the Enterprise Overview for deployment options.
| Requirement | Configuration |
|---|---|
| No data to Promptfoo servers | Use API-key/local providers for every generation, grading, embedding, and moderation path; avoid remote-only plugins, red team target/provider setup helpers, and red team target/provider test requests; disable telemetry; avoid Cloud sync and sharing |
| Local generation only | Set PROMPTFOO_DISABLE_REMOTE_GENERATION=true + configure local providers for supported generation paths |
| Air-gapped deployment | Use Enterprise On-Prem |