There are three ways to manage the behavior of a turbo 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| 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 |
| 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 | - |
| 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 | - | - |
| 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 | - |
| 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 | - | - |
| Behavior | Flags | Environment Variables | turbo.json |
|---|---|---|---|
| Run Summaries | --summarize | TURBO_RUN_SUMMARY | - |
| Graph visualization | --graph | - | - |
| Dry run | --dry | - | - |
| 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 | - |
| Behavior | Flags | Environment Variables | turbo.json |
|---|---|---|---|
| Binary path | - | TURBO_BINARY_PATH | - |
Download local turbo | - | TURBO_DOWNLOAD_LOCAL_ENABLED | - |
| Daemon | --daemon / --no-daemon | - | daemon |