cal.diy

Cal.diy is a community-maintained fork of Cal.com for running scheduling infrastructure on your own server. It supports event types, availability schedules, calendar connections, booking management and integrations. The project strictly recommends personal, non-production use and directs commercial users to Cal.com.

Key features

• Event types, recurring event types and seated events
• Booking management and private booking links with hashed URLs
• Availability schedules, date overrides and travel schedules
• Buffer times, minimum notice, booking limits and out-of-office settings
• Calendar integrations including Google Calendar, Outlook, Apple Calendar and CalDAV
• Video conferencing integrations including Daily.co, Zoom and Google Meet
• Paid events through Stripe or PayPal
• Webhooks and integrations with automation, CRM and messaging tools
• Inline, popup and floating-button embeds
• REST API v2, API keys and OAuth clients

Why it helps in Pakistan

• Keep control of your scheduling infrastructure through self-hosting.
• Inspect and modify the entire MIT-licensed codebase without an enterprise-code split.
• Run the software without a Cal.com account or licence key.
• Use availability rules and booking limits to define when personal appointments can be booked.
• Test calendar, conferencing and API integrations in a non-production environment.

• 01

  A developer in Lahore can test an embedded booking page on a local portfolio prototype.

• 02

  A student in Karachi can use a personal instance to arrange study sessions with recurring event types.

• 03

  A freelancer in Islamabad can evaluate calendar connections and availability rules before choosing a production scheduling service.

• 04

  A Pakistani software team can experiment with scheduling webhooks and API v2 in a non-production sandbox.

Hardware

Check the official docs for minimum CPU, RAM and storage requirements; no minimum hardware specification is stated.Docker source builds require an available database.

Operating system

Windows setup notes are provided for Git Bash, WSL and PowerShell.Check the official docs for supported OS versions.

Skills

Advanced server administrationDatabase managementSecuring sensitive dataEnvironment-variable configurationGit and command-line developmentDocker and Docker Compose for Docker-based setup

Accounts needed

No Cal.com account or licence key is required.Additional credentials may be needed for enabled integrations.Check the official docs for cloud-provider account requirements.

Commands are copied from the project's README and official docs.

1. 1

   Docker Compose: prepare the system

   Install Docker and Docker Compose. Clone with git clone --recursive https://github.com/calcom/cal.diy.git, then run cd cal.diy.
2. 2

   Create configuration and secrets

   Run cp .env.example .env. Generate NEXTAUTH_SECRET with openssl rand -base64 32 and CALENDSO_ENCRYPTION_KEY with openssl rand -base64 24. Add the generated values to .env instead of the default secret placeholders.
3. 3

   Configure Web Push and runtime settings

   Generate VAPID keys with npx web-push generate-vapid-keys. Set NEXT_PUBLIC_VAPID_PUBLIC_KEY and VAPID_PRIVATE_KEY in .env. Review DATABASE_URL and NEXT_PUBLIC_WEBAPP_URL. Do not commit real keys to .env.example.
4. 4

   Start the stack

   Optionally run docker compose pull. Start the web app, local PostgreSQL database and Prisma Studio with docker compose up -d.
5. 5

   Create your first user

   Open http://localhost:3000 or your configured NEXT_PUBLIC_WEBAPP_URL and complete the setup wizard. To skip calendar connection, navigate to <NEXT_PUBLIC_WEBAPP_URL>/event-types.

• Google Calendar

  Supported calendar integration; calendar connections can be added from Settings > Integrations.

• Outlook / Office 365 Calendar

  Listed as a supported calendar integration.

• Apple Calendar and CalDAV

  Both are listed as supported calendar connections.

• Daily.co

  Provides the documented Cal Video integration.

• Zoom, Google Meet and Microsoft Teams

  Listed as supported video conferencing integrations.

• Stripe and PayPal

  Supported for paid events. The sources do not establish payment-provider availability for Pakistani users.

• Zapier, n8n, Make and Pipedream

  Listed as supported automation integrations; enterprise Workflows are not included.

• HubSpot, Salesforce and Close

  Listed as supported CRM integrations.

• Discord, Telegram and WhatsApp

  Listed as messaging integrations; specific messaging actions are not described in the supplied sources.

• MailHog

  Captures emails during development and is required when E2E_TEST_MAILHOG_ENABLED is 1.

• Railway PostgreSQL

  An optional database host connected through DATABASE_URL. Railway documents service-variable references for internal connections.

• GitHub
• Homepage
• Community issue tracker
• MIT licence
• Docker images
• Railway PostgreSQL guide
• Commercial alternative: Cal.com