Environment Variables

All hitspec CLI flags that support environment variables are listed here. Environment variables are read at startup and can be overridden by explicit CLI flags.

Core Variables

Variable	Flag	Default	Description
`HITSPEC_ENV`	`--env`	`dev`	Active environment name
`HITSPEC_ENV_FILE`	`--env-file`		Path to `.env` file
`HITSPEC_CONFIG`	`--config`		Path to config file
`HITSPEC_TAGS`	`--tags`		Tags filter (comma-separated)

Output Variables

Variable	Flag	Default	Description
`HITSPEC_OUTPUT`	`--output`	`console`	Output format
`HITSPEC_OUTPUT_FILE`	`--output-file`		Output file path
`HITSPEC_QUIET`	`--quiet`	`false`	Suppress all output
`HITSPEC_NO_COLOR`	`--no-color`	`false`	Disable colored output

Execution Variables

Variable	Flag	Default	Description
`HITSPEC_TIMEOUT`	`--timeout`	`30s`	Request timeout
`HITSPEC_BAIL`	`--bail`	`false`	Stop on first failure
`HITSPEC_PARALLEL`	`--parallel`	`false`	Run in parallel
`HITSPEC_CONCURRENCY`	`--concurrency`	`5`	Max concurrent requests

Network Variables

Variable	Flag	Default	Description
`HITSPEC_PROXY`	`--proxy`		HTTP proxy URL
`HITSPEC_INSECURE`	`--insecure`	`false`	Disable SSL validation

Metrics Variables

Variable	Flag	Default	Description
`HITSPEC_METRICS`	`--metrics`		Metrics export format
`HITSPEC_METRICS_PORT`	`--metrics-port`	`9090`	Prometheus endpoint port
`HITSPEC_METRICS_FILE`	`--metrics-file`		JSON metrics output file
`DD_API_KEY`	`--datadog-api-key`		DataDog API key
`DD_SITE`	`--datadog-site`	`datadoghq.com`	DataDog site
`DD_TAGS`	`--datadog-tags`		DataDog tags (comma-separated)

Notification Variables

Variable	Flag	Default	Description
`HITSPEC_NOTIFY`	`--notify`		Notification service
`HITSPEC_NOTIFY_ON`	`--notify-on`	`failure`	When to notify
`SLACK_WEBHOOK`	`--slack-webhook`		Slack webhook URL
`SLACK_CHANNEL`	`--slack-channel`		Slack channel override
`TEAMS_WEBHOOK`	`--teams-webhook`		Teams webhook URL

Usage

Set variables in your shell profile, .env file, or CI/CD configuration:

# Shell profile
export HITSPEC_ENV=staging
export HITSPEC_TIMEOUT=60s
export HITSPEC_OUTPUT=json
export HITSPEC_BAIL=true

# CI/CD environment
HITSPEC_ENV=staging \
HITSPEC_OUTPUT=junit \
HITSPEC_OUTPUT_FILE=results.xml \
  hitspec run tests/

Boolean variables accept true, 1, or yes as truthy values. Everything else is falsy.

Last modified on February 10, 2026

Configuration Reference Assertion Operators

Getting Started

Core Concepts

Features

Guides

Examples

CLI Reference

Configuration

Assertions Reference

Built-in Functions

Authentication

Output Formats

Integrations

Environment Variables

Core Variables

Output Variables

Execution Variables

Network Variables

Metrics Variables

Notification Variables

Usage

​Core Variables

​Output Variables

​Execution Variables

​Network Variables

​Metrics Variables

​Notification Variables

​Usage

Core Variables

Output Variables

Execution Variables

Network Variables

Metrics Variables

Notification Variables

Usage