Skip to content

Book your meetings using Cal.com, running with Helm ⎈

Notifications You must be signed in to change notification settings

Pyrrha/calcom-helm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Calcom Helm

Cal.com is a powerful tool for booking meetings. It offers integrations that allow you to store contact information into a CRM as events booked in your calendar. The user-friendly interface helps your leads and customers easily connect with you.

Cal.com Interface

Purpose

This Helm Chart provides a proposal for deploying Cal.com on a Kubernetes cluster using Helm. It utilizes the Docker image provided by Cal.com.

Terminal Installation

Usage

# Add the Helm repository
helm repo add calcom https://pyrrha.github.io/calcom-helm

# Verify the repository
helm search repo calcom

Using standalone Calcom

To deploy Calcom as a standalone application, simply run:

helm upgrade --install --values values.yaml calcom calcom

In the values.yaml file, you should provide Ingress settings, Ingress class, and some TLS information for proper configuration. For detailed configuration options, please refer to the Variables section below.

Using Calcom Stack

To deploy Calcom along with a PostgreSQL database, run:

helm upgrade --install --values values.yaml calcom-stack calcom-stack

In the value file, you can also configure Ingress information. Additionally, you can use the PostgreSQL fields to specify the user, password, and database. However, it's important to note that this is not a secure option. The recommended approach is to use another secret for these credentials, following the guidance provided in postgresql.auth.existingSecret.

👉 An example of a Persistent Volume (PV) is provided to help you quickly get started. This PV will be used by the database to store all the information about the application. Please use it with caution.

Variables

The variables used in this Chart are based on the latest application environment file example. Some variables might be missing or have been newly introduced. We welcome contributions, so feel free to open a pull request to add missing variables.

Since many of these variables contain tokens or password information, they should be stored in a Kubernetes secret. Variables that have already been handled are located in the deployment file.

👉 You can find an example of the minimal required variables in the example directory.

Mandatory Runtime Variables

Warning

These variables must also be provided at runtime, or the Chart will not function correctly. They must be present in the secret referenced as secretRef in Calcom's values.

Variable Description
NEXT_PUBLIC_WEBAPP_URL The base URL of the site.
NEXTAUTH_SECRET Secret used to encrypt JWTs for NextAuth.
CALENDSO_ENCRYPTION_KEY Application Key for symmetric encryption and decryption. It must be 32 bytes for AES256 encryption algorithm.
DATABASE_URL The database URL including credentials.

Contributions

Thanks to all our contributors!

For now, you can open an issue or open a pull request to interract with the project.


Troubleshooting

Application Variable Not Working in the Chart

Development of the Chart may not always keep up with changes in the application. If you encounter an issue with a variable, first check if it's present in the deployment file. If it's missing, you can either open a pull request or an issue to have it added. Alternatively, you can customize the deployment file in your own configuration if necessary.