The Complete Production SOP: How to Deploy and Run Turborepo Remote Caching with Self-Hosted S3 / MinIO in Autonomous AI Agents

---
name: "turbo-remote-cache-s3"
description: "Share build and test computation caches across developers and CI using Turborepo Remote Cache."
metadata:
  author: "Vercel"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "setup turborepo remote cache s3"
  - "configure turbo.json outputs"
  - "slash ci build time turbo"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Turborepo Remote Caching with Self-Hosted S3 / MinIO

Configures Turborepo Remote Caching: running custom remote cache servers (turborepo-remote-cache) backed by AWS S3 or MinIO, configuring turbo.json outputs and dependencies, and slashing CI times by up to 85%.

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [
        "dist/**",
        ".next/**",
        "!.next/cache/**",
        "build/**"
      ],
      "cache": true
    },
    "lint": {
      "cache": true
    },
    "test": {
      "dependsOn": ["build"],
      "outputs": ["coverage/**"],
      "cache": true
    }
  }
}

name: CI Pipeline
on: [push, pull_request]
jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v3
        with:
          version: 8
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'pnpm'
      - run: pnpm install --frozen-lockfile
      - name: Run Build with Turborepo S3 Remote Cache
        env:
          TURBO_API: ${{ secrets.TURBO_REMOTE_CACHE_URL }}
          TURBO_TOKEN: ${{ secrets.TURBO_REMOTE_CACHE_TOKEN }}
          TURBO_TEAM: "monorepo-team"
        run: pnpm exec turbo run build test --summarize

#!/usr/bin/env bash
set -euo pipefail

echo "==> Cleaning local build artifacts..."
rm -rf .turbo apps/**/dist apps/**/.next packages/**/dist

echo "==> Running build pass (Remote Fetch Expected)..."
OUTPUT=$(npx turbo run build --summarize)

if echo "$OUTPUT" | grep -q ">>> FULL TURBO"; then
  echo "[SUCCESS] Remote caching with S3 verified. Full turbo hit!"
  exit 0
else
  echo "[WARN] Local or remote cache missed. Check S3 bucket connectivity."
  exit 1
fi