Documentation

Turborepo remote cache setup

Cachely speaks the Turborepo remote cache (Vercel Remote Cache) protocol, so turbo talks to it with the same three environment variables it uses for the hosted default - no account on another platform required.

Configure

export TURBO_API=https://remote.cachely.dev
export TURBO_TOKEN=<your-token>
export TURBO_TEAM=<any-non-empty-value>

The same workspace token works for Nx, Lerna, Turborepo, Gradle, and Bazel. TURBO_TEAM is required by the Turborepo CLI but its value is ignored - the token alone identifies your workspace.

Verify a remote hit

Run a cacheable task, delete the local cache, then run it again. The second run should report a remote cache hit rather than executing the task:

turbo run build
rm -rf .turbo/cache
turbo run build --summarize

--summarize writes a run summary under .turbo/runs/ recording, per task, whether the result came from the local cache, the remote cache, or a fresh execution. That file is the fastest way to prove the remote cache is actually being consulted.

Artifact signing

Turborepo can sign cache artifacts so a tampered payload is rejected on download. Turn it on in turbo.json and supply the key through TURBO_REMOTE_CACHE_SIGNATURE_KEY:

{
  "remoteCache": { "signature": true }
}

The key is yours and never leaves your builds - Cachely stores the signed artifact without being able to forge one. The Turborepo remote cache guide explains the trade-offs in more depth.

Next

Add it to your pipeline with CI setup, and give pull-request builds a read-only token per tokens and access control.

Cache your turbo tasks
Three environment variables, no Vercel account needed.
Start freeSee pricing