[[Vorlage(Getestet, bionic)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Programme_starten: Starten von Programmen]
[:Terminal: Ein Terminal öffnen]
[:sudo: Root-Rechte]
[:Editor:einen Editor öffnen]
}}}
[[Inhaltsverzeichnis(1)]]

[[Bild(./Radicale_Logo.png, 48, align=left)]]
[https://radicale.org/ Radicale] {en} ist ein Kalender- (CalDAV) und Adressbuch-Server (CardDAV). Er eignet sich besonders für kleine Netze, in denen keine eigene Nutzerkontrolle notwendig ist. In Kombination mit einem separaten [:Serverdienste#Webserver:Webserver] kann man allerdings auch größere Benutzergruppen inkl. Authentifizierung versorgen.

Radicale ist komplett in [:Python:] geschrieben.

Dieser Artikel beschreibt Radicale in der Versin 1.x, welches bis einschließlich Ubuntu 18.04 in den Paketquellen ist. Für Ubuntu 20.04 und neuer ist [:Radicale 2:] in den Paketquellen.

= Installation =
Radicale 1.x ist in den offiziellen Paketquellen enthalten.

{{{#!vorlage Paketinstallation
radicale, universe
}}}

= Konfiguration des Servers =

== Manuell starten ==
Nach der Installation ist es nötig, das Verzeichnis für die Log-Dateien zu erstellen, da dieses im manuellen Modus nicht automatisch erstellt wird.

{{{#!vorlage Befehl
sudo mkdir /var/log/radicale
}}}
Danach kann der Server mit dem Befehl:

{{{#!vorlage Befehl
sudo radicale
}}}
gestartet werden.

== Automatisch starten ==
Damit der Radicale-Server automatisch gestartet werden kann, muss in der Datei '''/etc/radicale/config''' bei der Zeile:

{{{
#daemon = False
}}}

das Zeichen `#` entfernt und der Status von "False" auf "True" gesetzt werden. Anschließend führt man das Gleiche in der Datei '''/etc/default/radicale''' durch, um den Server automatisch starten zu lassen:

{{{
#ENABLE_RADICALE=yes
}}}

Beim nächsten Neustart des Systems wird dann Radicale via [:systemd:] automatisch gestartet.

== Authentifizierung und Benutzerrechte ==
In der Grundkonfiguration gibt es keine Authentifizierung, d.h. grundsätzlich kann jeder auf den Server zugreifen. Außerdem sind keine Benutzer und Gruppen eingerichtet, so dass jeder Nutzer auf jeden Kalender zugreifen kann.

Dies kann natürlich geändert werden. Radicale unterstützt verschiedene Möglichkeiten zur Authentifizierung (z.B. HTTP BasisAuth, IMAP, LDAP, PAM) und es können Benutzer und Gruppen angelegt werden. Eine ausführliche Anleitung hierzu findet man in der [https://github.com/Kozea/Radicale/blob/3.0.x/DOCUMENTATION.md#authentication Dokumentation] {en}.

== Radicale als WSGI-Applikation ==
Wie (fast) alle in Python geschriebenen Webanwendungen unterstützt Radicale [wikipedia:Web_Server_Gateway_Interface:WSGI] und kann über einen entsprechenden Server (z.B. [:Gunicorn:] oder [:Apache_2.4:] mit [:Apache/mod_wsgi:mod_wsgi] ) ausgeliefert werden. Dadurch eignet sich der Kalenderserver auch für den Zugriff über das Internet und viele Zugriffe von Nutzern.

Details zur Konfiguration findet man in der [https://github.com/Kozea/Radicale/blob/3.0.x/DOCUMENTATION.md#wsgi-server Dokumentation] {en}.

= Konfiguration des Clients =
Aufgrund der Vielfalt der möglichen Clients wird hier nur auf die Grundstruktur eingegangen, alles andere findet sich auf der offiziellen [https://github.com/Kozea/Radicale/blob/3.0.x/DOCUMENTATION.md#starting-the-client Dokumentation der Entwickler] {en}.

Der Server ist unter der Adresse `http://Server-IP_ADRESSE:5232` erreichbar, die einzelnen Kalender und Kontakte (auf dem Server) befinden sich in jeweils einem Ordner pro Benutzer im Pfad '''/var/lib/radicale/collection/'''. Auf einzelne Kalender kann somit über die Adresse: 

{{{
Server-IP:5232/Benutzer/Kalender
#oder
Server-IP:5232/Benutzer/Kalender.ics
}}}
zugegriffen werden.

Auf Kontakte wird hingegen über:

{{{
Server-IP:5232/Benutzer/Kontakte.vcf
}}}
zugegriffen.

Wenn für den jeweiligen Benutzer die Kontakte-/Kalender-Datei nicht existiert, wird sie automatisch erstellt.

= Problembehebung =
== radicale-Problem in Ubuntu 18.04 beheben ==
radicale legt unter [:18.04:Ubuntu 18.04] eine Datei '''collections '''in dem Verzeichnis '''/var/lib/radicale''' an, es braucht aber ein Verzeichnis, um dort die Kalender zu speichern. Der Fehler kann folgendermaßen behoben werden, Pfade je nach Eintrag in '''filesystem_folder''' in '''/etc/radicale/config''' anpassen:

{{{#!vorlage Befehl
sudo service radicale stop 
sudo test -d /var/lib/radicale/collections || sudo rm /var/lib/radicale/collections 
sudo mkdir -p /var/lib/radicale/collections
sudo chown -R radicale:radicale /var/lib/radicale/collections
sudo service radicale start
}}}

== Thunderbird ==
Thunderbird kann mit Hilfe von [http://www.scalableogo.org/ SOGo] {en} auch auf CardDAV zugreifen und synchronisieren. Alternativ kann die relativ neue [:Thunderbird:]-Erweiterung [https://addons.mozilla.org/de/thunderbird/addon/cardbook Cardbook] {en} genutzt werden.

= Alternativen =
 * [packages:calendarserver:Apple Calendar Server]
 * [http://www.k5n.us/webcalendar.php WebCalendar] {en} - Kalenderserver ([packages:webcalendar:])
 * [:DAViCal:]
 * [http://www.lewe.com/index.php?option=com_content&view=article&id=107&Itemid=42 TeamCal Pro] {de} - Webkalender für Teams
 * [http://www.tutos.org/ TUTOS] {de} - weiterer Webkalender für Teams
 * [http://phpicalendar.net/ PHP iCalendar] {en} - Lesezugriff auf [wikipedia:iCalendar:]-Dateien
 * [:Archiv/SOGo:SOGo] - Groupware mit CalDAV-Implementation
 * [https://www.tine20.com/ Tine 2.0] {de} {en} - Groupware und Customer Relationship Management (CRM) mit CalDAV-Implementation

= Links =
 * [https://radicale.org/ Projektseite] {en}
 * [:Radicale 2:] - Version 2.x der Programms

#tag: Netzwerk, Server, Kommunikation, Kalender, Adressbuch