Skip to content
Nx remote cache

Share Nx task results without changing your graph.

Make cached task outputs available across CI and local development. Nx still computes input hashes and decides which tasks need to run.

.boringcache.toml
workspace = "my-org/app"

[adapters.nx]
tag = "nx-cache"
command = ["pnpm", "nx", "run-many", "-t", "build"]
boringcache nx
permissions:
  contents: read
  id-token: write

steps:
  - uses: boringcache/one@f0fb9b2d926a32b10c543e92093ba00c5a291b79 # v1.33.0
    with:
      mode: nx
      trust-policy: auto
  - run: pnpm nx run-many -t build
steps:
  - label: Build
    command: >
      boringcache ci run
      --oidc-provider buildkite
      -- boringcache nx
build:
  timeout: 1h
  id_tokens:
    BORINGCACHE_OIDC_TOKEN:
      aud: urn:boringcache:workload
  script:
    - boringcache ci run --oidc-provider gitlab -- boringcache nx

How BoringCache fits your build.

Matching task outputs

Restore saved results when the task inputs match.

Existing targets

Keep the targets and affected commands in your repository.

A shared workspace

Let teammates and CI reuse the same published results.

Connect shared storage to your Nx tasks.

Use BoringCache for remote task storage and access controls. Inspect task-cache reads and transfers alongside the other tools in your build.

See cache activity across your Nx builds.

Inspect task-cache reads, misses, transfers, and storage in one workspace.

Explore the workspace →
Storybook

Cache stored

BoringCache0.841 GiB
actions/cache6.045 GiB

86%

Less cache stored

Storybook · compared with actions/cache

Keep shared-cache publication in trusted jobs.

Give consumers restore access and publishers a separate permission. Connect supported CI through OIDC or use scoped credentials.

Connect your CI →

Separate readers and publishers

  • Trusted builds Publish shared cache for the next build Read + publish
  • Pull requests Restore cache without replacing it Read only
  • Local development Use a scoped credential for the workspace Scoped access

Before you connect.

Can BoringCache provide our Nx remote cache?
Yes. BoringCache provides a shared remote-cache endpoint and workspace for Nx. It does not replace Nx Cloud's broader CI features.
Can Nx share a workspace with Turborepo cache?
Yes. Nx and Turborepo keep separate protocols while sharing the same BoringCache workspace.
Read the Nx setup guide →

Start with your next Nx build.

Install the CLI. Run onboarding to connect your repository and configure your cache.

30 GB of cache free. No credit card required.

curl -sSL https://install.boringcache.com/install.sh | sh
boringcache onboard
boringcache nx