This project is an open-source implementation of the Turborepo custom remote cache server. If Vercel's official cache server isn't a viable option, this server is an alternative for self-hosted deployments. It supports several storage providers and deploys environments. Moreover, the project provides "deploy to " buttons for one-click deployments whenever possible.

This project is proudly supported by:

Notable projects that use TRRC

• GitHub Actions
• AWS CDK Construct
• Turbo Daemon

Documentation

• Supported Storage Providers
• Environment variables
• Deployment Instructions
• Enable custom remote caching in a Turborepo monorepo

Full documentation is available here

Contribute to this project

1. Clone this repository

   git clone git@github.com:ducktors/turborepo-remote-cache.git

2. Move inside repository folder

   cd turborepo-remote-cache

3. Install dependencies

   pnpm install

4. Copy example variables

   cp .env.example .env

5. Put your env vars to the env file. See Environment variables section for more details.

6. Run the project in development mode

   pnpm dev

How to commit

This repo uses Semantic Release with Conventional Commits. Releases are automatically created based on the type of commit message: feat for minor and fix for patch.

feat: new feature ---> 1.x.0
fix: fix a bug ---> 1.0.x

Contributors

Maksim Sinik 💻 ⚠️ 🤔 🚧 🧑‍🏫	Matteo Vivona 🚇 🛡️ 📖	Dario Lehmhus 💻	lommi 💻	Brian Muenzenmeyer 📖	Dobes Vandermeer 💻	Tan Zi Gang 💻
John Gozde 💻 📖	Sachin Patel 💻	Andrew Nagy 💻	Eugene Malihins 💻	Joe DeVivo 🚇	Daniel Kopp 💻	Tom Fletcher 💻 📖
Christopher Brookes 📖 💻	Pierre S. 💻	Daniel Mitrov 💻	Adrian Trzeciak 💻	Lorenz Nimmervoll 📖	James 📖	Nils Wiesinger 📖
Naoto Ida 📖	Gustavo Atencio Mauricio 📖	Eric White 💻	Sani Music 📖 💻	Ivan Vasilev 💻	NullVoxPopuli 💻	Matt 📖
Luca Taddeo 🚧	Luke Rohde 💻	Hendrig Sellik 📖	Rodrigo Gonzalez 💻	Aleksandr Kondrashov 💻	Neil Enns 💻	Matteo Agnoletto 💻
Melroy van den Berg 📖

2.6.2 (2025-11-05)

Bug Fixes

• deps: bump koa from 2.16.2 to 2.16.3 (a17cb3e)

2.6.1 (2025-07-11)

Bug Fixes

• update devDeps and fix lint error on s3.ts (b6374e2)

2.6.0 (2025-05-27)

Bug Fixes

• clean-up request handler instantiation following latest version of aws sdk 3 recommendations (5d17d46)
• make maxSockets as provider option (9a1d0c5)

Features

• s3: customize maxSockets parameter for the aws sdk (250216e)

2.5.0 (2025-04-22)

Features

• add SSL support (cc73331)
• add SSL support (b78af84)
• add SSL support (ad5409c)

2.4.0 (2025-04-22)

Features

• add HTTP/2 support via environment variable (33e5efb)
• add HTTP2 flag to environment configuration and update app initialization (04a43bc)

2.3.9 (2025-04-18)

Bug Fixes

• deps: bump fastify from 5.3.1 to 5.3.2 (ca2db8a)

2.3.8 (2025-04-18)

Bug Fixes

• deps: bump fastify from 5.1.0 to 5.3.1 (12b3de9)

2.3.7 (2025-04-14)

Bug Fixes

• S3 - store upload promise early in order to complete createWriteStream (a81cc85)

2.3.6 (2025-04-11)

Bug Fixes

• deps: Migrate aws sdk to v3 (7f33b6a)

2.3.5 (2025-03-19)

Bug Fixes

• remove expose port from dockerfile (34e7272)

2.3.4 (2025-03-05)

Bug Fixes

• simplify dockerfile and fix ghr docker image name (4495504)

2.3.3 (2025-03-05)

Bug Fixes

• change name of LOG_LEVEL_PROBE (7e0641c)

2.3.2 (2025-03-05)

Bug Fixes

• pnpm audit fix (4f64569)

2.3.1 (2025-02-20)

Bug Fixes

• remove package.json import on status page (ad63d6e)

2.3.0 (2025-02-20)

Features

• Add JWT Authentication and Authorization (4828fed)

2.2.12 (2025-02-10)

Bug Fixes

• update aws-sdk to patch GHSA-776f-qx25-q3cc (96d3d71)

2.2.11 (2025-02-08)

Bug Fixes

• Do not allow logger and loggerInstance to simultaneously exist in fastifyOptions (6c69249)

2.2.10 (2025-02-08)

Bug Fixes

• remove corepack (a4288f8)

2.2.9 (2025-02-08)

Bug Fixes

• deps: update version of duplexify to 4.1.3 (cb69b32)

2.2.8 (2024-11-29)

Bug Fixes

• update node on dockerfile (a9dd8cb)

2.2.7 (2024-11-27)

Bug Fixes

• change logger config (5c7d495)
• logger options only accepts a configuration object #479 (705d9bf)

2.2.6 (2024-11-27)

Bug Fixes

• update fastify and plugins to 5.0 (d0be6ed)

2.2.5 (2024-11-19)

Bug Fixes

• deps: bump cross-spawn from 6.0.5 to 6.0.6 (cba4fbd)

2.2.4 (2024-11-15)

Bug Fixes

• deps: bump path-to-regexp from 6.2.1 to 6.3.0 (60edba9)

2.2.3 (2024-11-15)

Bug Fixes

• deps: bump micromatch from 4.0.5 to 4.0.8 (b24e0d3)

2.2.2 (2024-11-15)

Bug Fixes

• Use BODY_LIMIT when creating app (c0d999f)

2.2.1 (2024-06-11)

Bug Fixes

• raise the bodyLimit to 50MB from 1MB (968f422)

2.2.0 (2024-06-10)

Features

• ABS: replace legacy azure-storage lib with @azure/storage-blob (806f3c7)

2.1.5 (2024-06-04)

Bug Fixes

• use team or fallback to teamId (85e1bdb)

2.1.4 (2024-05-22)

Bug Fixes

• docker: bump node from 20.13.0-alpine3.18 to 20.13.1-alpine3.18 (716e82c)

2.1.3 (2024-05-09)

Bug Fixes

• docker: bump node from 20.11.1-alpine3.18 to 20.13.0-alpine3.18 (43d49b5)

2.1.2 (2024-04-08)

Bug Fixes

• package.json to reduce vulnerabilities (473f191)

2.1.1 (2024-04-08)

Bug Fixes

• bump node on dockerfile (d130524)

2.1.0 (2024-03-29)

Features

• support minio (0fb851f)

2.0.9 (2024-03-21)

Bug Fixes

• docs: use recommended docker config for remote cache (2f23bf4)

2.0.8 (2023-12-05)

Bug Fixes

• add pnpm overrides (e0eecad)

2.0.7 (2023-12-04)

Bug Fixes

• docker: bump node from 4b30609 to 984d561 (7e66ca3)

2.0.6 (2023-11-30)

Bug Fixes

• docker: bump node from 20.9.0-alpine3.17 to 20.10.0-alpine3.17 (96a9f04)

2.0.5 (2023-11-21)

Bug Fixes

• docker: bump node from 21.1.0-alpine3.17 to 21.2.0-alpine3.17 (adde832)

2.0.4 (2023-11-03)

Bug Fixes

• docker: bump node from 21.0.0-alpine3.17 to 21.1.0-alpine3.17 (bc97812)

2.0.3 (2023-10-24)

Bug Fixes

• docker: bump node from 18.18.1-alpine3.17 to 18.18.2-alpine3.17 (e993fdf)

2.0.2 (2023-10-13)

Bug Fixes

• docker: bump node from 18.18.0-alpine3.17 to 18.18.1-alpine3.17 (5f00985)

2.0.1 (2023-09-25)

Bug Fixes

• update Vercel function handler (8f9d5bb)

2.0.0 (2023-09-22)

Features

• update package.json exports field (17f9c6f)
• use tsx, biome and node --test (61f018a)

BREAKING CHANGES

• use ES2022 and ESM as compile target

1.15.1 (2023-09-20)

Bug Fixes

• docker: bump node from 18.17.1-alpine3.17 to 18.18.0-alpine3.17 (57b84e8)

1.15.0 (2023-08-25)

Features

• allow logging on file (2f0b9c0)

1.14.7 (2023-08-21)

Bug Fixes

• docker: bump node from 18.17.0-alpine3.17 to 18.17.1-alpine3.17 (940f4e9)

1.14.6 (2023-08-09)

Bug Fixes

• docker: bump node from e2a7e89 to e0641d0 (b534b64)

1.14.5 (2023-08-09)

Bug Fixes

• docker: bump node from d04e594 to e2a7e89 (3163a05)

1.14.4 (2023-08-03)

Bug Fixes

• remove pnpm from package engine (ce435e0)

1.14.3 (2023-07-21)

Bug Fixes

• docker: bump node from 18.16.1-alpine3.17 to 18.17.0-alpine3.17 (e247c19)

1.14.2 (2023-06-23)

Bug Fixes

• docker: bump node from 18.15.0-alpine3.17 to 18.16.1-alpine3.17 (8a97f95)

1.14.1 (2023-03-27)

Bug Fixes

• docker: bump node from f605fcd to ffc770c (3524d08)
• docker: bump node from f605fcd to ffc770c (b731acd)
• update fastify/aws-lambda (45cc851)

1.14.0 (2023-03-21)

Features

• unprotected health route (7f68884)
• unprotected unversioned health route (3fe7e2c)

1.13.3 (2023-03-21)

Bug Fixes

• docker: bump node from 18.14.2-alpine3.17 to 18.15.0-alpine3.17 (f9d6260)

1.13.2 (2023-02-26)

Bug Fixes

• docker: bump node from 18.14.1-alpine3.17 to 18.14.2-alpine3.17 (c4099cc)

1.13.1 (2023-02-20)

Bug Fixes

• docker: bump node from 18.14.0-alpine3.17 to 18.14.1-alpine3.17 (872226f)

1.13.0 (2023-02-10)

Bug Fixes

• return the reply object (4d0b3cb)
• Set content type explicitly (8f87111)

Features

• update to fastify 4 (0384fb4)

1.12.3 (2023-02-08)

Bug Fixes

• deps: bump @google-cloud/storage from 6.4.1 to 6.9.1 (c6901c8)
• deps: bump @google-cloud/storage to 6.9.2 (8e5c327)
• deps: bump @hapi/boom from 9.1.4 to 10.0.0 (6efbff4)
• deps: bump @sinclair/typebox from 0.23.1 to 0.25.21 (48b0047)
• deps: bump aws-sdk from 2.1053.0 to 2.1308.0 (a34ab72)
• deps: bump pino-pretty from 7.3.0 to 9.1.1 (207a9e6)

1.12.2 (2023-02-06)

Bug Fixes

• deps: bump tslib from 2.3.1 to 2.5.0 (18cffd8)

1.12.1 (2023-02-05)

Bug Fixes

• deps: update fastify-autoload, ajv and env-schema (b2ded8f)

1.12.0 (2023-02-03)

Features

• docker: update nodejs on docker image (f24352e)

1.11.0 (2023-02-02)

Features

• add azure blob storage support (c4bd04d)

1.10.2 (2023-01-16)

Bug Fixes

• update fastify to v3.29.4 (b2133a5)

1.10.1 (2022-12-20)

Bug Fixes

• minor doc fixes (4c5e166)

1.10.0 (2022-12-14)

Bug Fixes

• fix navigation (9aa97f2)
• Move lambda docs into deployment instructions (65a42ec)

Features

• add docs on local environment variables (cb0c35f)
• how to run in aws lambda (ff30348)
• provide aws proxy handler (9dcf280)

1.9.0 (2022-12-13)

Features

• use AWS_SESSION_TOKEN (90cadc6)

1.8.0 (2022-11-12)

Bug Fixes

• add missing comma, silent is not a valid loglevel, log only errors instead (a8ec568)
• use file for commitizen config (7623239)

Features

• add status endpoint (a0a1cd7)

1.7.4 (2022-11-05)

Bug Fixes

• replace npm ci with npm i to allow build on arm (76f895d)

1.7.3 (2022-11-05)

Bug Fixes

• #32, #62 (1052cb7)
• remove mapped envs (ea614b3)
• typescript (2f2902e)
• update dockerfile (e03a900)

1.7.2 (2022-11-04)

Bug Fixes

• remove need for VERCEL_* (9e6dd06)

1.7.1 (2022-11-03)

Bug Fixes

• Fixed problem with GCS_PRIVATE_KEY being escaped and causing an error (59d5d5d)

1.7.0 (2022-10-14)

Features

• trigger release of head support #50 (bc3bd8a)

1.6.7 (2022-10-11)

Bug Fixes

• don't require AWS env vars (33ffe5e)

1.6.6 (2022-09-27)

Bug Fixes

• update node (cf0db61)

1.6.5 (2022-09-15)

Bug Fixes

• enable npm autopublish (11c01d9)

1.6.4 (2022-09-15)

Bug Fixes

• adds ignore-script on dockerimage (2e4f4d2)

1.6.3 (2022-09-15)

Bug Fixes

• updates docker workflow event trigger (7a96374)

1.6.2 (2022-09-15)

Bug Fixes

• renames workflows (9495a8f)
• updates release workflow (3741bac)