Cal.com installieren: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
(weitere Hinweise zur Administration)
KKeine Bearbeitungszusammenfassung
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 36: Zeile 36:
Per Default ist in unserem Ansible Skript das Selbst-Anlegen von Benutzern deaktiviert.
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.
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 ==
== Weitere Hinweise zur Administration ==
Zeile 44: Zeile 44:
Wenn Du Änderungen an der Datei <code>cal.com/.env</code> vorgenommen hast, musst du folgende Befehle ausführen, um die Änderungen zu aktivieren:
Wenn Du Änderungen an der Datei <code>cal.com/.env</code> vorgenommen hast, musst du folgende Befehle ausführen, um die Änderungen zu aktivieren:


  cd cal.com
<syntaxhighlight lang="bash">
  yarn build --force
cd cal.com
  systemctl --user restart calcom
yarn build --force
systemctl --user restart calcom
</syntaxhighlight>


=== Prisma Studio ===
=== Prisma Studio ===
Zeile 52: Zeile 54:
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.
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
<syntaxhighlight lang="bash">
  yarn db-studio
cd cal.com
yarn db-studio
</syntaxhighlight>


Das "Prisma Studio" läuft dann auf Port 5555, und kann von außen über eine Port Weiterleitung erreicht werden:
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
<syntaxhighlight lang="bash">
ssh xyz00-cal@xyz00.hostsharing.net -L 8080:localhost:5555
</syntaxhighlight>


Nun kann im lokalen Browser über http://localhost:8080 auf das "Prisma Studio" zugegriffen werden.
Nun kann im lokalen Browser über http://localhost:8080 auf das "Prisma Studio" zugegriffen werden.

Aktuelle Version vom 14. Juni 2024, 11:07 Uhr

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/.env vorgenommen, 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.

Links