turbo-linux-64

2.8.17 verified Sat Apr 25 auth: no javascript

The Linux x64 binary for Turbo (Turborepo), a high-performance monorepo build system by Vercel. Current stable version is 2.8.17. This package is a platform-specific dependency automatically installed by the main `turbo` package; you should never install it directly. Turborepo provides incremental builds, task orchestration, remote caching, and parallel execution. It uses a Go-based core for speed and a Rust-based successor in development (Turborepo 2.0+). Alternatives include Nx and Lerna, but Turbo is simpler to configure and optimizes for CI/CD.

Common errors

error Error: Cannot find module 'turbo' ↓

cause Installed turbo-linux-64 instead of main 'turbo' package, or missing main package.

fix

Install the main turbo package: npm install turbo

error Error: ⨯ Unable to resolve turbo binary for platform linux x64 ↓

cause The turbo-linux-64 optional dependency didn't install (e.g., due to network issues or lockfile conflicts).

fix

Delete node_modules/.cache/turbo and run npm install again. If using CI, ensure platform-specific optional deps are not filtered.

error Error: ENOENT: no such file or directory, open 'turbo.json' ↓

cause Missing turbo.json configuration file in project root.

fix

Create a turbo.json file at the root of your monorepo with pipeline configuration.

Warnings

gotcha Do not install turbo-linux-64 directly. It is an optional dependency of the 'turbo' package and platform-specific. Installing it directly will likely cause version mismatches. ↓

fix Install the main 'turbo' package instead: npm install turbo

breaking Turborepo v2.x changed the task dependency syntax from ^depends-on to dependsOn with a caret prefix notation. Old configs may be incompatible. ↓

fix Update turbo.json to use the new pipeline format: "dependsOn": ["^build"] instead of "dependsOn": ["build"]

deprecated The 'globalDependencies' field is deprecated in favor of 'globalDependencies' with a different schema. Check docs. ↓

fix Use 'globalDependencies' as an array of strings (not objects) in turbo.json

gotcha Turborepo requires Node.js >= 14.x and npm/yarn/pnpm. Not compatible with older engines. ↓

fix Upgrade Node.js to version 14 or higher.

Install

npm install turbo-linux-64

yarn add turbo-linux-64

pnpm add turbo-linux-64

Imports

turbo
wrong
```
import turbo from 'turbo'
```
correct
```
const turbo = require('turbo')
```
The main turbo package is a CLI tool, not a library. It should not be imported in application code. Use it via command line or npm scripts.
run
wrong
```
require('turbo').run('build')
```
correct
```
turbo run build
```
Turbo is used as a CLI: `npx turbo run <task>`. Do not require() it programmatically.
Package.json Script
wrong
```
"scripts": { "build": "turbo build" }
```
correct
```
"scripts": { "build": "turbo run build" }
```
Turbo requires `run` subcommand before the task name. Running `turbo build` without `run` is a common mistake.

Quickstart

Shows minimal turbo.json pipeline config and basic turbo CLI usage in a monorepo.

// Install turbo globally or in project
npm install -g turbo

# Create a turbo.json config file in your monorepo root
cat > turbo.json <<EOF
{
  "$schema": "https://turbo.build/schema.json",
  "globalDependencies": [".env"],
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**"]
    },
    "test": {
      "dependsOn": ["build"],
      "inputs": ["src/**/*.tsx"]
    }
  }
}
EOF

# Run build for all workspaces
turbo run build

# Run test only for changed packages
npx turbo run test --filter=...[HEAD^1]