Nx Remote Cache

Avrea provides a self-hosted remote cache endpoint for Nx monorepos. Task outputs are cached so that unchanged projects skip builds, tests, and lint entirely.

Requires Nx 20.8 or newer. The self-hosted remote cache and Nx Cloud are mutually exclusive. A workspace connected to Nx Cloud uses Cloud instead.

On Avrea runners

Nx environment variables are pre-configured:

NX_SELF_HOSTED_REMOTE_CACHE_SERVER="http://cache.avrea.com:8290/nx-build"
NX_SELF_HOSTED_REMOTE_CACHE_ACCESS_TOKEN="unused"

Your workflow needs no changes:

workflow.yml

jobs:
  build:
    runs-on: avrea-ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v6
        with:
          node-version: 24
      - run: pnpm install --frozen-lockfile
      - run: pnpm nx run-many -t build

Manual setup

Set the environment variables in your workflow:

env:
  NX_SELF_HOSTED_REMOTE_CACHE_SERVER: "http://cache.avrea.com:8290/nx-build"
  NX_SELF_HOSTED_REMOTE_CACHE_ACCESS_TOKEN: "unused"

No changes to nx.json are required.