reference-local-dev

title: Local Development Setup
impact: LOW
impactDescription: Reference guide for local development environment
tags: reference, development, setup

Local Development Setup

Initial Setup

# Install dependencies
yarn

# Set up environment
cp .env.example .env

Environment Variables

Generate required secrets:

# NEXTAUTH_SECRET
openssl rand -base64 32

# CALENDSO_ENCRYPTION_KEY (must be 32 characters for AES256)
openssl rand -base64 24

Configure in `.env`:

• `DATABASE_URL` - PostgreSQL connection string
• `DATABASE_DIRECT_URL` - Same as DATABASE_URL

Database Setup

# Development
yarn workspace @calcom/prisma db-migrate

# Production
yarn workspace @calcom/prisma db-deploy

Test Users

When setting up local development database, it creates test users. The passwords are the same as the username:

• `free:free`
• `pro:pro`

Logging

Control logging verbosity by setting `NEXT_PUBLIC_LOGGER_LEVEL` in .env:

• 0: silly
• 1: trace
• 2: debug
• 3: info
• 4: warn
• 5: error
• 6: fatal

API v2 Imports

If you need to import from `@calcom/features` or `@calcom/trpc` into `apps/api/v2`, use the platform-libraries package instead:

// ✅ Good
import { SomeService } from "@calcom/platform-libraries";

// ❌ Bad - Will cause module resolution errors
import { SomeService } from "@calcom/features/...";