Merge pull request #459 from vitvitlabs/main

Add Cal.com API v2 service and Redis to Docker Compose

Author: dcharles525

.env.example

@@ -15,6 +15,17 @@ LICENSE=
 NEXT_PUBLIC_WEBAPP_URL=http://localhost:3000
 NEXT_PUBLIC_API_V2_URL=http://localhost:5555/api/v2
 
+API_PORT=80
+API_URL=http://localhost:5555/api/v2
+LOG_LEVEL=info
+
+WEB_APP_URL=http://localhost:3000/
+CALCOM_LICENSE_KEY=
+API_KEY_PREFIX=cal_
+GET_LICENSE_KEY_URL="https://console.cal.com/api/license"
+IS_E2E=false
+DOCS_URL=
+
 # Configure NEXTAUTH_URL manually if needed, otherwise it will resolve to {NEXT_PUBLIC_WEBAPP_URL}/api/auth
 # NEXTAUTH_URL=http://localhost:3000/api/auth
 
@@ -38,6 +49,10 @@ DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${DATABASE_HOST}
 DATABASE_DIRECT_URL=${DATABASE_URL}
 GOOGLE_API_CREDENTIALS={}
 
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_URL=redis://${REDIS_HOST}:${REDIS_PORT}
+
 # Set this to '1' if you don't want Cal to collect anonymous usage
 CALCOM_TELEMETRY_DISABLED=
 
@@ -65,3 +80,35 @@ NODE_ENV=production
 # Set this to 'non-strict' to enable CSP for support pages. 'strict' isn't supported yet. Also, check the README for details.
 # Content Security Policy
 CSP_POLICY=
+
+# VAPID keys for push notifications
+# Generate using: npx web-push generate-vapid-keys
+NEXT_PUBLIC_VAPID_PUBLIC_KEY=
+VAPID_PRIVATE_KEY=
+
+# Used for stripe integration
+# See https://stripe.com/docs/keys
+STRIPE_API_KEY=sk_test_your_stripe_test_key_here
+STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret_here
+STRIPE_TEAM_MONTHLY_PRICE_ID=price_your_team_price_id_here
+STRIPE_PRICE_ID_STARTER=
+STRIPE_PRICE_ID_STARTER_OVERAGE=
+STRIPE_PRICE_ID_ESSENTIALS=
+STRIPE_PRICE_ID_ESSENTIALS_OVERAGE=
+STRIPE_PRICE_ID_ENTERPRISE=
+STRIPE_PRICE_ID_ENTERPRISE_OVERAGE=
+IS_TEAM_BILLING_ENABLED=false
+
+# Axiom logging
+AXIOM_DATASET=
+AXIOM_TOKEN=
+
+# DEBUG: 0
+# INFO: 1
+# WARN: 2
+# ERROR: 3
+LOGGER_BRIDGE_LOG_LEVEL="1"
+
+# 1: Rewrite /api/v2 to /v2
+# 0: Don't rewrite
+REWRITE_API_V2_PREFIX="1"

README.md

@@ -67,6 +67,29 @@ If you are evaluating Cal.com or running with minimal to no modifications, this
 
     Most configurations can be left as-is, but for configuration options see [Important Run-time variables](#important-run-time-variables) below.
 
+    **Push Notifications (VAPID Keys)**  
+    If you see an error like:
+
+    ```
+    Error: No key set vapidDetails.publicKey
+    ```
+
+    This means your environment variables for Web Push are missing.  
+    You must generate and set `NEXT_PUBLIC_VAPID_PUBLIC_KEY` and `VAPID_PRIVATE_KEY`.
+
+    Generate them with:
+    ```bash
+    npx web-push generate-vapid-keys
+    ```
+
+    Then update your `.env` file:
+    ```env
+    NEXT_PUBLIC_VAPID_PUBLIC_KEY=your_public_key_here
+    VAPID_PRIVATE_KEY=your_private_key_here
+    ```
+
+    Do **not** commit real keys to `.env.example` — only placeholders.
+
     Update the appropriate values in your .env file, then proceed.
 
 4. (optional) Pre-Pull the images by running the following command:

docker-compose.yaml

@@ -2,6 +2,7 @@
 
 volumes:
   database-data:
+  redis-data:
 
 networks:
   stack:
@@ -19,6 +20,17 @@ services:
     networks:
       - stack
 
+  redis:
+    container_name: redis
+    image: redis:latest
+    restart: always
+    volumes:
+      - redis-data:/data
+    networks:
+      - stack
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+
   calcom:
     image: calcom.docker.scarf.sh/calcom/cal.com
     build:
@@ -50,6 +62,58 @@ services:
     depends_on:
       - database
 
+  calcom-api:
+    container_name: calcom-api
+    build:
+      context: ./calcom
+      dockerfile: apps/api/v2/Dockerfile
+      args:
+        DATABASE_URL: ${DATABASE_URL}
+        DATABASE_DIRECT_URL: ${DATABASE_URL}
+    restart: always
+    networks:
+      - stack
+    ports:
+      - "${API_PORT:-80}:${API_PORT:-80}"
+    env_file: .env
+    environment:
+      - NODE_ENV=${NODE_ENV}
+      - API_PORT=${API_PORT:-80}
+      - API_URL=${API_URL}
+      - DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${DATABASE_HOST}/${POSTGRES_DB}
+      - DATABASE_READ_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${DATABASE_HOST}/${POSTGRES_DB}
+      - DATABASE_WRITE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${DATABASE_HOST}/${POSTGRES_DB}
+      - DATABASE_DIRECT_URL=${DATABASE_URL}
+      - NEXTAUTH_SECRET=${NEXTAUTH_SECRET}
+      - JWT_SECRET=${JWT_SECRET}
+      - REDIS_URL=${REDIS_URL}
+      - LOG_LEVEL=${LOG_LEVEL}
+      - API_KEY_PREFIX=${API_KEY_PREFIX}
+      - WEB_APP_URL=${WEB_APP_URL}
+      - IS_E2E=${IS_E2E:-false}
+      - REWRITE_API_V2_PREFIX=${REWRITE_API_V2_PREFIX:-true}
+      - CALCOM_LICENSE_KEY=${CALCOM_LICENSE_KEY}
+      - NEXT_PUBLIC_VAPID_PUBLIC_KEY=${NEXT_PUBLIC_VAPID_PUBLIC_KEY}
+      - VAPID_PRIVATE_KEY=${VAPID_PRIVATE_KEY}
+      - STRIPE_API_KEY=${STRIPE_API_KEY}
+      - STRIPE_WEBHOOK_SECRET=${STRIPE_WEBHOOK_SECRET}
+      - STRIPE_PRICE_ID_STARTER=${STRIPE_PRICE_ID_STARTER}
+      - STRIPE_PRICE_ID_STARTER_OVERAGE=${STRIPE_PRICE_ID_STARTER_OVERAGE}
+      - STRIPE_PRICE_ID_ESSENTIALS=${STRIPE_PRICE_ID_ESSENTIALS}
+      - STRIPE_PRICE_ID_ESSENTIALS_OVERAGE=${STRIPE_PRICE_ID_ESSENTIALS_OVERAGE}
+      - STRIPE_PRICE_ID_ENTERPRISE=${STRIPE_PRICE_ID_ENTERPRISE}
+      - STRIPE_PRICE_ID_ENTERPRISE_OVERAGE=${STRIPE_PRICE_ID_ENTERPRISE_OVERAGE}
+      - STRIPE_TEAM_MONTHLY_PRICE_ID=${STRIPE_TEAM_MONTHLY_PRICE_ID}
+      - IS_TEAM_BILLING_ENABLED=${IS_TEAM_BILLING_ENABLED:-false}
+      - AXIOM_DATASET=${AXIOM_DATASET}
+      - AXIOM_TOKEN=${AXIOM_TOKEN}
+      - LOGGER_BRIDGE_LOG_LEVEL=${LOGGER_BRIDGE_LOG_LEVEL}
+      - DOCS_URL=${DOCS_URL}
+      - GET_LICENSE_KEY_URL=${GET_LICENSE_KEY_URL}
+    depends_on:
+      - database
+      - redis
+
 # Optional use of Prisma Studio. In production, comment out or remove the section below to prevent unwanted access to your database.
   studio:
     image: calcom.docker.scarf.sh/calcom/cal.com