Comment installer Cal.com avec Docker

Cet article couvre les méthodes d'installation courantes et avancées, ainsi que la mise à jour de votre instance Cal.com.

Exigences préalables

Assurez-vous d'avoir Docker et Docker Compose installés sur votre système. Ces outils sont généralement inclus avec Docker Desktop ou Rancher Desktop. Notez que docker compose (sans le trait d'union) est désormais la méthode recommandée par Docker.

Comment exécuter Cal.com avec Docker Compose

Cette méthode est la plus simple et la plus recommandée pour la plupart des utilisateurs.

1. Démarrer Cal.com via Docker Compose : Choisissez l'une des commandes suivantes en fonction de vos besoins :
   • Note : Pour exécuter en mode attaché (utile pour le débogage et voir les logs en direct), retirez l'option -d de la commande choisie.
2. Accéder à Cal.com : Ouvrez votre navigateur web et accédez à http://localhost:3000 (ou l'URL que vous avez définie via NEXT_PUBLIC_WEBAPP_URL dans votre fichier .env). Lors de la première exécution, un assistant de configuration apparaîtra pour vous guider dans la création de votre premier utilisateur administrateur.

Pour exécuter uniquement l'application web Cal.com avec une base de données distante : Assurez-vous que la variable DATABASE_URL est correctement configurée dans votre fichier .env.

docker compose up -d calcom

Pour exécuter l'application web Cal.com et Prisma Studio avec une base de données distante : Assurez-vous que la variable DATABASE_URL est correctement configurée dans votre fichier .env pour pointer vers votre base de données distante.

docker compose up -d calcom studio

Pour exécuter la pile complète (base de données Postgres locale, application web Cal.com, et Prisma Studio) :Bash

docker compose up -d

Pré-télécharger les images (facultatif) : Vous pouvez télécharger toutes les images Docker nécessaires à l'avance en utilisant cette commande. Cela peut accélérer le démarrage initial.

docker compose pull

Préparer votre configuration : Copiez le fichier d'exemple des variables d'environnement et renommez-le en .env. Vous devrez ensuite mettre à jour ce fichier avec vos propres configurations.

cp .env.example .env

Ouvrez le fichier .env (par exemple, avec nano .env ou votre éditeur de texte préféré) et ajustez les valeurs nécessaires. Consultez la section "Important Run-time variables" du README original si vous avez besoin de plus de détails sur les options de configuration.

Accéder au répertoire : Naviguez dans le répertoire docker nouvellement créé :

cd docker

Cloner le dépôt calcom/docker : Ouvrez votre terminal et exécutez la commande suivante pour cloner le dépôt Docker de Cal.com. L'option --recursive est importante pour inclure les sous-modules nécessaires.

git clone --recursive https://github.com/calcom/docker.git

Mettre à jour Cal.com

Pour mettre à jour votre instance Cal.com vers la dernière version :

1. Mettre à jour les variables d'environnement : Si de nouvelles variables d'environnement sont requises par la dernière version, mettez à jour votre fichier .env en conséquence. Vous pouvez comparer avec le fichier .env.example le plus récent.

Redémarrer la pile Cal.com :Bash

docker compose up -d

Tirer les dernières modifications :Bash

docker compose pull

Arrêter la pile Cal.com :Bash

docker compose down

Construire et exécuter Cal.com (utilisateurs avancés)

Cette méthode est destinée aux utilisateurs qui souhaitent construire l'image Docker de Cal.com à partir des sources.

1. Construire l'image Docker de Cal.com : Note : Une base de données fonctionnelle est actuellement requise pendant le processus de construction.
   • a) Si vous hébergez ailleurs (base de données distante) : Configurez la variable DATABASE_URL dans votre fichier .env pour pointer vers votre base de données distante et passez à l'étape de construction directe.
2. Démarrer Cal.com via Docker Compose : Les options sont les mêmes que pour la méthode "Running Cal.com with Docker Compose" :
   • Note : Pour le mode débogage, retirez -d.
3. Accéder à Cal.com : Ouvrez votre navigateur web et accédez à http://localhost:3000 (ou l'URL que vous avez définie via NEXT_PUBLIC_WEBAPP_URL). L'assistant de configuration vous guidera pour créer votre premier utilisateur.

Pour exécuter uniquement l'application web Cal.com avec une base de données distante :

docker compose up -d calcom

Pour exécuter l'application web Cal.com et Prisma Studio avec une base de données distante :

docker compose up -d calcom studio

Pour exécuter la pile complète (Postgres local, application web Cal.com, Prisma Studio) :

docker compose up -d

Construire Cal.com via Docker Compose :

DOCKER_BUILDKIT=0 docker compose build calcom

b) Si une base de données locale ou temporaire est requise : Démarrez une base de données locale via Docker Compose avant de construire l'image Cal.com.

docker compose up -d database

Préparer votre configuration : Copiez le fichier d'exemple des variables d'environnement et renommez-le en .env. Mettez à jour ce fichier avec vos configurations.

cp .env.example .env

Consultez la section "Build-time variables" du README original pour les options de configuration spécifiques à la construction.

Mettre à jour le sous-module calcom : Ceci télécharge le code source de l'application Cal.com elle-même.

git submodule update --remote --init

Note : N'utilisez PAS la mise à jour récursive des sous-modules, cela pourrait entraîner une erreur d'authentification Git.

Accéder au répertoire : Naviguez dans le répertoire calcom-docker :

cd calcom-docker

Cloner le dépôt calcom/docker : Cloner le dépôt et spécifier un nom de répertoire pour éviter les conflits si vous avez déjà un répertoire docker.

git clone https://github.com/calcom/docker.git calcom-docker

J'espère que cette procédure détaillée vous sera utile pour installer Cal.com avec Docker !