Radicale – Behaltet die Kontrolle über Eure
Kontakte, Kalender & Aufgaben¶

Voraussetzungen¶

Python ist zur Ausführung von Radicale erforderlich, installiert folgende Pakete auf dem Server:

sudo apt install python3 python3-pip

Installation¶

Installiert Radicale:

sudo apt install python3-radicale

Legt als nächstes einen Systembenutzer an, der Radicale ausführen soll. Für die Zwecke dieses Tutorials nennen wir diesen Systembenutzer radicaleadmin. Natürlich könnt Ihr jeden beliebigen Namen wählen, stellt dabei nur sicher, dass Ihr die Befehle entsprechend anpasst:

sudo useradd --system --home-dir / --shell /sbin/nologin radicaleadmin

Es wird keine Datenbank benötigt, erstellt einfach einen Ordner, in dem die Daten von Radicale abgespeichert werden:

sudo mkdir -p /var/lib/radicale/collections

BenutzerInnen¶

Radicale unterstützt mehrere BenutzerInnen. Jeder Nutzer kann über eigene Kalender, Kontakte und Aufgabenlisten verfügen. Der Zugriff kann durch Zugangsdaten gesichert werden, die in einer verschlüsselten Datei auf dem Server gespeichert werden.

Installiert die folgenden Pakete, um die Verschlüsselung zu aktivieren:

sudo apt install python3-passlib python3-bcrypt

Erstellt nun ein Verzeichnis für die Zugangsdaten:

sudo mkdir /var/www/radicale

Legt schließlich ein erstes Benutzerkonto mit dem folgenden Befehl an, der unter anderem den -c Parameter übergibt. Ersetzt den Parameter $USER durch den tatsächlichen Benutzernamen. Wenn Ihr dazu aufgefordert werdet, gebt ein sicheres, individuelles Passwort ein:

sudo htpasswd -B -c /var/www/radicale/users $USER

Zur Veranschaulichung legen wir drei Benutzer an — Georg, Lenina und Tom:

sudo htpasswd -B -c /var/www/radicale/users Georg
sudo htpasswd -B /var/www/radicale/users Lenina
sudo htpasswd -B /var/www/radicale/users Tom

Beachtet, dass der -c Parameter lediglich zur Erstellung des ersten Benutzers übergeben werden muss, in diesem Fall "Georg". Zur Erstellung weiterer BenutzerInnen kann der Parameter hingegen entfernt werden, in diesen Fall "Lenina" sowie "Tom".

Überprüft abschließend, ob alle Zugangsdaten korrekt erstellt wurden:

sudo cat /var/www/radicale/users

Die Terminal-Ausgabe sollte in etwa folgendermaßen aussehen:

Georg:$2y$05$Zsb8MYlKjRr2InVi/IQNtustqfdnHWN14uG9jNNhx1g rF7a/8Cg6
Lenina:$2y$05$Hh2Y8nrikm 9f1Pz8LrOFe K5NR HlL0Qz3Yvv gupSBgIr4lT0bi
Tom:$2y$05$1BnHnXCqNHXZtWMiFhnxBOpYM9xeVnZXm70SoTclEfsrI JPSvDVy

Einstellungen¶

Erstellt ein Verzeichnis, in dem alle Einstellungen abgelegt werden:

sudo mkdir /etc/radicale

Öffnet die Konfigurationsdatei:

sudo vi /etc/radicale/config

Ergänzt oder ändert die folgenden Zeilen:

[server]
hosts               = 0.0.0.0:5232, [::]:5232
max_connections     = 20
max_content_length  = 10000000
timeout             = 10

[auth]
type                = http_x_remote_user
htpasswd_filename   = /var/www/radicale/users
htpasswd_encryption = bcrypt
delay               = 5

[storage]
filesystem_folder   = /var/lib/radicale/collections

Hier ein paar Zusatzinformationen zu diesen Einstellungen:

Zugriffsrechte¶

Zugriffsrechte auf die Verzeichnisse /var/lib/radicale (enthält Daten), /var/www/radicale (enthält verschlüsselte Zugangsdaten) und /etc/radicale (enthält Einstellungen) werden auf den Nutzer radicaleadmin beschränkt:

sudo chown -R radicaleadmin:radicaleadmin /var/lib/radicale
sudo chmod -R 700 /var/lib/radicale

sudo chown -R radicaleadmin:radicaleadmin /var/www/radicale
sudo chmod -R 755 /var/www/radicale

sudo chown -R radicaleadmin:radicaleadmin /etc/radicale
sudo chmod -R 700 /etc/radicale

Autostart¶

Stellt sicher, dass Radicale bei jedem Hochfahren des Servers automatisch gestartet wird. Erstellt eine Konfigurationsdatei:

sudo vi /etc/systemd/system/radicale.service

Gebt den folgenden Text ein und passt den Inhalt (Benutzernamen, usw.) entsprechend an:

[Unit]
Description=A simple CalDAV (calendar) and CardDAV (contact) server
After=network.target
Requires=network.target

[Service]
ExecStart=/usr/bin/env python3 -m radicale
Restart=on-failure
User=radicaleadmin
Group=radicaleadmin
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
PrivateDevices=true
ProtectKernelTunables=true
ProtectKernelModules=true
ProtectControlGroups=true
NoNewPrivileges=true
ReadWritePaths=/var/lib/radicale/collections

[Install]
WantedBy=multi-user.target

Stellt sicher, dass Radicale bei jedem Boot-Vorgang automatisch gestartet wird:

sudo systemctl daemon-reload
sudo systemctl enable radicale

Startet den Server neu:

sudo reboot

Vergewissert Euch, dass Radicale aktiv ist und läuft (der Status sollte "Activ" sein):

sudo systemctl status radicale

Erstellt eine Apache-Konfigurationsdatei:

sudo vi /etc/apache2/sites-available/myradicale.gofoss.duckdns.org.conf

Fügt den folgenden Inhalt hinzu und stellt sicher, dass Ihr die Einstellungen an Eure eigene Konfiguration anpasst, wie z. B. den Domain-Namen (myradicale.gofoss.duckdns.org), den Pfad zu SSL-Schlüsseln, die IP-Adressen und so weiter:

<VirtualHost *:80>

ServerName              myradicale.gofoss.duckdns.org
ServerAlias             www.myradicale.gofoss.duckdns.org
Redirect permanent /    https://myradicale.gofoss.duckdns.org/

</VirtualHost>

<VirtualHost *:443>

ServerName              myradicale.gofoss.duckdns.org
ServerAlias             www.myradicale.gofoss.duckdns.org
ServerSignature         Off

<IfModule security2_module>
    SecRuleEngine Off
</IfModule>

SSLEngine               On
SSLProxyEngine          On
SSLProxyCheckPeerCN     Off
SSLCertificateFile      /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem
SSLCertificateKeyFile   /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem

<Location />
    Order deny,allow
    Deny from all
    Allow from 127.0.0.1
    Allow from 192.168.1.0/24
    Allow from 10.8.0.1/24
</Location>

RewriteEngine On
RewriteRule ^/radicale$ /radicale/ [R,L]

<Location "/radicale/">
    AuthType      Basic
    AuthName      "Radicale - Password Required"
    AuthUserFile  "/var/www/radicale/users"
    Require       valid-user

    ProxyPass        http://localhost:5232/ retry=0
    ProxyPassReverse http://localhost:5232/
    RequestHeader    set X-Script-Name /radicale/
RequestHeader    set X-Remote-User expr=%{REMOTE_USER}
</Location>

ErrorLog ${APACHE_LOG_DIR}/myradicale.gofoss.duckdns.org-error.log
CustomLog ${APACHE_LOG_DIR}/myradicale.gofoss.duckdns.org-access.log combined

</VirtualHost>

Speichert und schließt die Datei (:wq!).

Man beachte, dass die SSL-Verschlüsselung für Radicale mit der Anweisung SSLEngine On aktiviert und das zuvor erstellte SSL-Zertifikat /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem sowie der private SSL-Schlüssel /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem verwendet wurden.

Man beachte des Weiteren, dass ModSecurity in der Apache-Konfigurationsdatei mit der Anweisung SecRuleEngine Off deaktiviert wurde, da Radicale und ModSecurity nicht gut miteinander harmonieren.

Aktiviert als nächstes den Apache Virtual Host und ladet Apache neu:

sudo a2ensite myradicale.gofoss.duckdns.org.conf
sudo systemctl reload apache2

Konfiguriert Pi-Hole, um die lokale Adresse von Radicale nutzen zu können. Ruft https://mypihole.gofoss.duckdns.org auf und meldet Euch über die Pi-Hole-Weboberfläche an (passt die URL entsprechend an). Öffnet den Menüeintrag Locale DNS Records und fügt die folgende Domain/IP-Kombination hinzu (passt die URL sowie IP entsprechend an):

DOMAIN:      myradicale.gofoss.duckdns.org
IP ADDRESS:  192.168.1.100

Ruft https://myradicale.gofoss.duckdns.org auf und meldet Euch an. Erstellt je nach Bedarf Kalender, Adressbücher und Aufgabenlisten.

Um manuelle Datensicherungen durchzuführen, meldet Euch bei https://myradicale.gofoss.duckdns.org/radicale an (passt die URL entsprechend an) und klickt auf die URL-Links von Adressbüchern, Kalendern und Aufgabenlisten, um Eure Daten herunterzuladen.

Ihr könnt ebenfalls automatische Sicherungen der Verzeichnisse /var/lib/radicale, /var/www/radicale und /etc/radicale durchführen.