REDIS_URL missing in .env.example for api/v2

[ifrah-ashraf]

REDIS_URL required to run API V2 locally?

Hi team ,

I'm trying to run the API V2 server locally using the official command:

yarn workspace @calcom/api-v2 dev

However, I’m encountering an error regarding a missing environment variable REDIS_URL,
which is not present in the official .env.example file.

Error log

info: Starting Nest application... {"context":"NestFactory","service":"cal-platform-api","timestamp":"2025-06-13 20:44:37.391"}
error: Missing environment variable: REDIS_URL. {"context":"ExceptionHandler","service":"cal-platform-api","stack":["Error: Missing environment variable: REDIS_URL.\n    at getEnv (/home/dell/Desktop/cal.com/apps/api/v2/src/env.ts:48:11)\n    at InstanceWrapper.loadConfig [as metatype] (/home/dell/Desktop/cal.com/apps/api/v2/src/config/app.ts:25:23)\n    at Injector.instantiateClass (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/injector.js:368:55)\n    at callback (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/injector.js:65:45)\n    at processTicksAndRejections (node:internal/process/task_queues:105:5)\n    at Injector.resolveConstructorParams (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/injector.js:144:24)\n    at Injector.loadInstance (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/injector.js:70:13)\n    at Injector.loadProvider (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/injector.js:97:9)\n    at /home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/instance-loader.js:56:13\n    at async Promise.all (index 4)\n    at InstanceLoader.createInstancesOfProviders (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/instance-loader.js:55:9)\n    at /home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/instance-loader.js:40:13\n    at async Promise.all (index 3)\n    at InstanceLoader.createInstances (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/instance-loader.js:39:9)\n    at InstanceLoader.createInstancesOfDependencies (/home/dell/Desktop/cal.com/node_modules/@nestjs/core/injector/instance-loader.js:22:13)\n    at /home/dell/Desktop/cal.com/node_modules/@nestjs/core/nest-factory.js:108:17"],"timestamp":"2025-06-13 20:44:37.517"}

Is Redis mandatory to run the API V2 server locally or I'm doing it the wrong way.

[dosubot[bot]]

Hi @ifrah-ashraf! I'm Dosu and I’m helping the cal.com team.

Redis is mandatory for running the API V2 server locally—the codebase enforces the presence of the REDIS_URL environment variable, and the server will not start without it. The absence of REDIS_URL in the .env.example file is an oversight. To resolve the error, add a line like REDIS_URL=redis://localhost:6379 to your .env file (pointing to your local or accessible Redis instance) source.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[ifrah-ashraf]

Yeah it's working thanks