Deploy Cal.diy on AWS: A Complete Developer Guide

Welcome to our comprehensive developer guide for deploying Cal.diy on AWS! Cal.diy is the open-source, self-hostable community edition of Cal.com, and with our pre-configured AMI, you can get it running in your own AWS environment in minutes.

This guide will walk you through every step, from launching the AMI to configuring your domain and securing your instance. Let's get started!

Related Article

How to Self-Host Cal.diy in AWS with Pre-Configured AMI

Master self-hosting Cal.diy, the open-source community edition of Cal.com, on AWS with our comprehensive installation guide, featuring a pre-configured AMI, perfect for users in the UK, USA, Europe, Ireland, Singapore, and Thailand

Meetrix.IO | Kelum Sampath

Launching the Cal.diy AMI from AWS Marketplace

Step 1: Subscribe to the AMI

1. Navigate to the 'Cal.diy' listing in the AWS Marketplace.
2. Click the Continue to Subscribe button.
3. Accept the terms and conditions by clicking Accept Terms.
4. After a brief processing period, click Continue to Configuration.

Step 2: Configure and Launch

1. On the "Configure this software" page, select your desired AWS region.
2. Click Continue to Launch.
3. From the "Choose Action" dropdown, select Launch CloudFormation.
4. Click Launch. This will redirect you to the CloudFormation console to create a new stack.

Deploying with CloudFormation

Step 1: Create Stack

1. You'll be taken to the "Create stack" page. Ensure the "Template is ready" option is selected.
2. Click Next.

Step 2: Specify Stack Details

Provide the necessary parameters for your Cal.diy deployment. These settings define how your instance will be configured.

After filling in the details, click Next.

Step 3: Configure Stack Options

1. Under "Stack failure options," choose Roll back all stack resources. This ensures that failed deployments are automatically cleaned up.
2. Click Next.

Step 4: Review and Submit

1. Review all the details you've entered.

2. Acknowledge that CloudFormation might create IAM resources by ticking the checkbox.

3. Click Submit to start the deployment.

You will be redirected to the CloudFormation stacks page, where you can monitor the deployment progress.

The stack creation process typically takes 5-10 minutes. Wait for the status to change to CREATE_COMPLETE.

Configuring Your DNS

Step 1: Get the Public IP Address

Once the stack is created, go to the Outputs tab and copy the value of PublicIp.

Step 2: Create a DNS Record

1. Go to your DNS provider (e.g., AWS Route 53, GoDaddy, Cloudflare).
2. Create an A record for your domain (e.g., cal.yourdomain.com).
3. Point the record to the PublicIp you copied in the previous step.

4. Save the record.

Accessing Your Cal.diy Instance

You can now access your Cal.diy application using the DashboardUrl from the CloudFormation "Outputs" tab.

502 Bad Gateway Error?

If you see a "502 Bad Gateway" error, don't worry! The application is likely still starting up. Please wait about 5 minutes and then refresh the page.

Manual SSL Certificate Generation

If your domain is not hosted on Route 53, the automatic SSL setup might fail. In that case, you'll need to generate the certificate manually.

Step 1: SSH into the Server

1. From the CloudFormation "Outputs" tab, copy the PublicIp.

2. Open your terminal and use the following command to connect to the server. Replace your-key.pem with your key pair file.

ssh -i "your-key.pem" ubuntu@<Public IP address>

Step 2: Run the Certificate Script

Once logged in, run the following script. It will prompt you to enter your domain name and email address.

sudo /root/certificate_generate_standalone.sh

Managing Your Cal.diy Instance

Shutting Down and Restarting

1. In the CloudFormation stack's Resources tab, click the link for the Instance to go to the EC2 console.

2. Select the instance and use the Instance state dropdown to Stop instance or Start instance.

Removing the Deployment

To completely remove the Cal.diy application and all associated resources, simply delete the CloudFormation stack from the AWS console.

API Documentation

Cal.diy is built on the same codebase as Cal.com and exposes a powerful REST API that allows you to control the entire platform programmatically. You can find self-hosting documentation here:

Official Cal.diy Self-Hosting Documentation

Upgrading Your Instance

We regularly update our AMI with the latest version of Cal.diy. To upgrade, you can launch a new instance with the newer version and migrate your data. Remember to back up your server data before removing the old instance.

Troubleshooting Common Issues

1. vCPU Quota Error: If you see an error about vCPU limits, please follow this guide to request an increase.

2. Insufficient Capacity: If you get an "insufficient instance capacity" error, try launching the stack in a different AWS region or at a later time.

3. Dashboard Error on First Load: If the dashboard doesn't load immediately, wait 5-10 minutes for the services to initialize and then try again.

Conclusion

Congratulations! You have successfully deployed Cal.diy on your AWS account. With this self-managed setup, you have full control over your scheduling infrastructure, data, and branding. Cal.diy is best suited to personal projects and non-production use; if you need a production-grade scheduling platform with official support, the managed Cal.com SaaS product is the better fit.

Technical Support

If you run into any issues, our support team is here to help. Reach out to us at support@meetrix.io.