Here’s how you can get Cal.com running locally with Docker Compose, including PostgreSQL, the web frontend, and API v2:

1. Clone the main repo if you haven’t already:

   git clone https://github.com/calcom/cal.com.git
   cd cal.com
   

2. Docker Compose setup:
   The main Compose file is at infra/docker/docker-compose.yml in the repo. It orchestrates the database, API, and web services. The Docker setup is community-driven and referenced in the docs—see here.

3. Environment variables:
   Copy .env.example to .env in the repo root and fill in required values.

   • Make sure to set NEXTAUTH_SECRET and CALENDSO_ENCRYPTION_KEY (generate with openssl rand -base64 32).
   • Set CALCOM_LICENSE_KEY (required for API v2).
   • Add REDIS_URL=redis://localhost:6379 (API v2 won’t start without it) source.
   • Check .env.example and apps/api/v2/.env.example for all needed variables.

4. Build and start everything:

   docker compose -f infra/docker/docker-compose.yml up --build
   

   This will spin up PostgreSQL, API (including v2), and the web frontend. The Compose file uses the monorepo root as build context, so all packages are included.

5. Access the app:

   • Web frontend: http://localhost:3000
   • API v2: http://localhost:5555/api/v2 (or whatever port is set in your Compose/env)

6. Troubleshooting:

   • If API v2 fails to start, double-check REDIS_URL and CALCOM_LICENSE_KEY.
   • Make sure your DATABASE_URL matches the running Postgres container (default is usually postgresql://postgres:postgres@db:5432/calendso).

Sample Compose snippet (simplified for reference—see the actual file for full details):

services:
  db:
    image: postgres:13
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: calendso
    ports:
      - "5432:5432"
  redis:
    image: redis:7
    ports:
      - "6379:6379"
  api:
    build:
      context: ../..
      dockerfile: infra/docker/api/Dockerfile
    env_file: ../../.env
    depends_on:
      - db
      - redis
    ports:
      - "5555:80"
  web:
    build:
      context: ../..
      dockerfile: infra/docker/web/Dockerfile
    env_file: ../../.env
    depends_on:
      - api
    ports:
      - "3000:3000"

For more details, check the infra/docker/README.md and the main README. The Compose setup is flexible, so you can tweak ports, envs, and volumes as needed.

Let me know if you need help with a specific part of the stack or run into any errors!

To reply, just mention @dosu.

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

Hi, could you please share that updated guide with me?