Options overview

There are three ways to manage the behavior of a turbo invocation:

• Configuration in turbo.json
• System Environment Variables
• Flags passed to the CLI invocation

The three strategies listed above are in order of precedence. Where a flag value is provided, for the same System Environment Variable or turbo.json configuration, the value for the flag will be used. Because of this, we recommend using:

• turbo.json configuration for defaults
• System Environment Variables for per-environment overrides
• Flags for per-invocation overrides

Options table

Caching

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Force tasks to run	--force	TURBO_FORCE	cache
Remote Cache timeout	--remote-cache-timeout	TURBO_REMOTE_CACHE_TIMEOUT	remoteCache.timeout
Remote Cache upload timeout	-	TURBO_REMOTE_CACHE_UPLOAD_TIMEOUT	remoteCache.uploadTimeout
Cache signature key	-	TURBO_REMOTE_CACHE_SIGNATURE_KEY	signature
Preflight request	--preflight	TURBO_PREFLIGHT	remoteCache.preflight
Remote Cache base URL	-	TURBO_API	remoteCache.apiUrl
Cache sources	--cache	TURBO_CACHE	-
Local cache directory	--cache-dir	TURBO_CACHE_DIR	cacheDir
Local cache max age	-	TURBO_CACHE_MAX_AGE	cacheMaxAge
Local cache max size	-	TURBO_CACHE_MAX_SIZE	cacheMaxSize

</div>

Messages

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Disable version print	-	TURBO_PRINT_VERSION_DISABLED	-
Disable telemetry message	-	TURBO_TELEMETRY_MESSAGE_DISABLED	-
Disable global turbo warning	-	TURBO_GLOBAL_WARNING_DISABLED	-
No update notifier	-	TURBO_NO_UPDATE_NOTIFIER	noUpdateNotifier

</div>

Task running and logs

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Terminal UI	--ui	TURBO_UI	ui
Run affected tasks	--affected	-	-
Disable package manager check	--dangerously-disable-package-manager-check	TURBO_DANGEROUSLY_DISABLE_PACKAGE_MANAGER_CHECK	dangerouslyDisablePackageManagerCheck
Affected base ref	-	TURBO_SCM_BASE	-
Affected head ref	-	TURBO_SCM_HEAD	-
Only run directly specified tasks	--only	-	-
Task concurrency	--concurrency	TURBO_CONCURRENCY	-
Task log order	--log-order	TURBO_LOG_ORDER	-
Current working directory	--cwd	-	-
Streamed logs prefix	--log-prefix	-	-
Task logs output level	--output-logs-option	-	outputLogs
Global inputs	--global-deps	-	globalDependencies
Terminal colors	--color	FORCE_COLOR	-

</div>

Environment variables

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Environment variable mode	--env-mode	-	envMode
Vendor environment variables	-	TURBO_CI_VENDOR_ENV_KEY	-
Framework variable exceptions	--framework-inference	-	-

</div>

Debugging outputs

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Run Summaries	--summarize	TURBO_RUN_SUMMARY	-
Graph visualization	--graph	-	-
Dry run	--dry	-	-

</div>

Authentication

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Login URL	-	TURBO_LOGIN	remoteCache.loginUrl
Team name (for multi-team Remote Cache)	--team	TURBO_TEAM	-
Team ID (for multi-team Remote Cache)	-	TURBO_TEAMID	-
Authentication token	--token	TURBO_TOKEN	-

</div>

Other

<div className="options-cheat-sheet-table">

Behavior	Flags	Environment Variables	turbo.json
Binary path	-	TURBO_BINARY_PATH	-
Download local turbo	-	TURBO_DOWNLOAD_LOCAL_ENABLED	-
Daemon (deprecated)	--daemon / --no-daemon	-	daemon

</div>