Global Options Reference¶

Options that affect all tasks. Full docs: https://turborepo.dev/docs/reference/configuration

globalEnv¶

Environment variables affecting all task hashes.

{
  "globalEnv": ["CI", "NODE_ENV", "VERCEL_*"]
}

Use for variables that should invalidate all caches when changed.

globalDependencies¶

Files that affect all task hashes.

{
  "globalDependencies": [
    "tsconfig.json",
    ".env",
    "pnpm-lock.yaml"
  ]
}

Lockfile is included by default. Add shared configs here.

globalPassThroughEnv¶

Variables available to tasks but not included in hash.

{
  "globalPassThroughEnv": ["AWS_SECRET_KEY", "GITHUB_TOKEN"]
}

Use for credentials that shouldn't affect cache keys.

cacheDir¶

Custom cache location. Default: node_modules/.cache/turbo.

{
  "cacheDir": ".turbo/cache"
}

daemon¶

Background process for faster subsequent runs. Default: true.

{
  "daemon": false
}

Disable in CI or when debugging.

envMode¶

How unspecified env vars are handled. Default: "strict".

{
  "envMode": "strict"  // Only specified vars available
  // or
  "envMode": "loose"   // All vars pass through
}

Strict mode catches missing env declarations.

ui¶

Terminal UI mode. Default: "stream".

{
  "ui": "tui"     // Interactive terminal UI
  // or
  "ui": "stream"  // Traditional streaming logs
}

TUI provides better UX for parallel tasks.

remoteCache¶

Configure remote caching.

{
  "remoteCache": {
    "enabled": true,
    "signature": true,
    "timeout": 30,
    "uploadTimeout": 60
  }
}

Option	Default	Description
`enabled`	`true`	Enable/disable remote caching
`signature`	`false`	Sign artifacts with `TURBO_REMOTE_CACHE_SIGNATURE_KEY`
`preflight`	`false`	Send OPTIONS request before cache requests
`timeout`	`30`	Timeout in seconds for cache operations
`uploadTimeout`	`60`	Timeout in seconds for uploads
`apiUrl`	`"https://vercel.com"`	Remote cache API endpoint
`loginUrl`	`"https://vercel.com"`	Login endpoint
`teamId`	-	Team ID (must start with `team_`)
`teamSlug`	-	Team slug for querystring

See https://turborepo.dev/docs/core-concepts/remote-caching for setup.

concurrency¶

Default: "10"

Limit parallel task execution.

{
  "concurrency": "4"     // Max 4 tasks at once
  // or
  "concurrency": "50%"   // 50% of available CPUs
}

futureFlags¶

Enable experimental features that will become default in future versions.

{
  "futureFlags": {
    "errorsOnlyShowHash": true
  }
}

`errorsOnlyShowHash`¶

When using outputLogs: "errors-only", show task hashes on start/completion:

Cache miss: cache miss, executing <hash> (only logging errors)
Cache hit: cache hit, replaying logs (no errors) <hash>

noUpdateNotifier¶

Disable update notifications when new turbo versions are available.

{
  "noUpdateNotifier": true
}

dangerouslyDisablePackageManagerCheck¶

Bypass the packageManager field requirement. Use for incremental migration.

{
  "dangerouslyDisablePackageManagerCheck": true
}

Warning: Unstable lockfiles can cause unpredictable behavior.

When working in Git worktrees, Turborepo automatically shares local cache between the main worktree and linked worktrees.

How it works:

Detects worktree configuration
Redirects cache to main worktree's .turbo/cache
Works alongside Remote Cache

Benefits:

Cache hits across branches
Reduced disk usage
Faster branch switching

Disabled by: Setting explicit cacheDir in turbo.json.