Cal.com installieren
Allgemein
Cal.com [1] (früher Calendso) ist eine Open Source Lösung, die es Kunden ermöglicht, Termine bei einer Beraterin oder einem Sachbearbeiter zu buchen. Es ist eine Alternative zu calendly.
Cal.com kann auch selbst gehostet werden, unter der Lizenz AGPL. Der Code steht im Github Repository zur Verfügung.
Technische Details
Cal.com ist in Typescript geschrieben und setzt eine Installation von Node voraus.
Es gibt ein Ansible Skript, das die Installationsschritte für cal.com automatisiert durchführt.
Die Quellen für das Ansible Skript können hier eingesehen werden: [2]
Installation
Was das Ansible Skript macht, lässt sich mit diesen Worten beschreiben:
- Es wird ein Linux Benutzer eingerichtet.
- Es wird eine Postgresql Datenbank eingerichtet.
- Es wird eine Domain aufgeschaltet.
- Es wird das Github Repository in der aktuellen Version heruntergeladen.
- Dann werden ein paar Konfigurationen an der Datei
cal.com/.envvorgenommen, um die Postgresql Datenbank einzurichten, und E-Mail Konfiguration und anderes einzurichten. - Es wird Node.js eingerichtet, und mit yarn werden die benötigten Pakete installiert.
- Es müssen noch ein paar Patches angewendet werden, damit unser Postgresql 11 noch auf Debian Buster unterstützt wird.
- Dann wird die Datenbank initialisiert.
- Und es werden die Dateien für den Produktivbetrieb vorbereitet.
- Es wird ein systemd Dienst im Userspace eingerichtet, der den Node Server startet.
- Es wird der Apache in der htaccess Datei konfiguriert, damit die aufgeschaltete Domain über Proxy auf den cal.com Dienst verweist.
Einrichtung
Nach der Installation läuft die Anwendung auf der konfigurierten Domain.
Dann legt man den ersten Benutzer als Administrator auf der Webseite an.
Per Default ist in unserem Ansible Skript das Selbst-Anlegen von Benutzern deaktiviert.
Um weitere Benutzer anzulegen, kann der Administrator ein Team anlegen, und dort weitere Benutzer mit ihrer E-Mail Adresse einladen. Leider ist in der Open Source Variante das Formular zur Anmeldung nicht enthalten. Die Benutzer müssen also über Prisma Studio (siehe unten) angelegt werden.
Weitere Hinweise zur Administration
Änderungen an der Konfigurationsdatei
Wenn Du Änderungen an der Datei cal.com/.env vorgenommen hast, musst du folgende Befehle ausführen, um die Änderungen zu aktivieren:
cd cal.com yarn build --force systemctl --user restart calcom
Prisma Studio
Das "Prisma Studio" (siehe auch https://www.prisma.io/studio) ist eine Administrationsoberfläche für cal.com, um direkt in die Datenbank schauen zu können und um Änderungen vorzunehmen. Das sollte nur mit Vorsicht genutzt werden.
cd cal.com yarn db-studio
Das "Prisma Studio" läuft dann auf Port 5555, und kann von außen über eine Port Weiterleitung erreicht werden:
ssh xyz00-cal@xyz00.hostsharing.net -L 8080:localhost:5555
Nun kann im lokalen Browser über http://localhost:8080 auf das "Prisma Studio" zugegriffen werden.