From 8a0ea3ea75dc519d5445df070a32f1e55987cc30 Mon Sep 17 00:00:00 2001 From: Jocomol Date: Thu, 7 Oct 2021 22:39:03 +0200 Subject: added radicale --- radicale.html | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 radicale.html (limited to 'radicale.html') diff --git a/radicale.html b/radicale.html new file mode 100644 index 0000000..35dbf7d --- /dev/null +++ b/radicale.html @@ -0,0 +1,70 @@ + + + + Setting up Radicale – LandChad.net + + + + + + + +

Setting up a calDAV server - Radicale

+ +
+ +

Radicale is an open source calDAV server. CalDAV is a widely supported internet standard for calendars, todo-lists and contacts. Hosting your own calDAV server allows sharing calendars between mutliple devices.

+

More information can be found on the projects offical website: radicale.org.

+

Installing Radicale

+

Firstly, we have to install radicale on our system, luckily for us radicale is packaged for the most used distros.

+
apt install radicale apache2-utils
+

Next we need to configure Radicale. We configure radicale to be accessible from other machines, how Radicale and where the files should be stored. Open /etc/radicale/config with your favourite editor and add this configuration.

+
[server]
+# Bind all addresses
+hosts = 0.0.0.0:5232, [::]:5232
+
+[auth]
+type = htpasswd
+htpasswd_filename = /etc/radicale/users
+htpasswd_encryption = md5
+
+[storage]
+filesystem_folder = /var/lib/radicale/collections
+ +

As you can see under [auth] we use htpasswd to manage the users. Execute the following command to add a new user to Radicale.

+
htpasswd -c /etc/radicale/users username
+

As Radicale stands now it is fully functional and after starting it by executing its binary, can be accessed under example.org:5232. But there are two additional things we can do to make using and managing Radicale way easier.

+

Setting up a Nginx reverse proxy

+

Because the URL of your Radicale server is an URL you will have to remember and enter it on any device you want to use your calendar on it is advised to set up a reverse proxy.

+
server {
+	listen 443 ssl;
+	listen [::]:443 ssl;
+	server_name cal.example.org;
+	location / {
+		proxy_pass http://localhost:5232/; # The / is important!
+	}
+	# You can also leave these two lines out and use certbot
+	ssl_certificate /etc/ssl/nginx/cal.example.com/fullchain.pem;
+	ssl_certificate_key /etc/ssl/nginx/cal.example.com/privkey.pem;
+}
+

Run as a service

+

Running Radicale as a service makes managing it much easier. Add this config to /etc/systemd/system/radicale.service.

+
[Unit]
+Description=A simple CalDAV (calendar) and CardDAV (contact) server
+
+[Service]
+ExecStart=/usr/bin/env python3 -m radicale
+Restart=on-failure
+
+[Install]
+WantedBy=default.target
+

After creating the config load, start and enable the service with the following commands.

+
systemctl daemon-reload
+systemctl enable --now radicale
+

Contribution

+
  • Author: Jocomol – jocomol.ch -- XMR: 41kLv68Nk4N3zvTRFYtHZfRRFMgXkxK2FcXDeCSa4yNwBGTBa1WQ8HtXL8cCAcoZ2iSLBCS6HQqdpRSf56ecMBgWTkn2ARt +
  • +
    + + + -- cgit v1.2.3 From 3ee7076324f465c2e59339042d0aa924d00b86d8 Mon Sep 17 00:00:00 2001 From: Jocomol Date: Fri, 8 Oct 2021 10:58:46 +0200 Subject: added missing words in a sentence --- radicale.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'radicale.html') diff --git a/radicale.html b/radicale.html index 35dbf7d..029de7c 100644 --- a/radicale.html +++ b/radicale.html @@ -18,7 +18,7 @@

    Installing Radicale

    Firstly, we have to install radicale on our system, luckily for us radicale is packaged for the most used distros.

    apt install radicale apache2-utils
    -

    Next we need to configure Radicale. We configure radicale to be accessible from other machines, how Radicale and where the files should be stored. Open /etc/radicale/config with your favourite editor and add this configuration.

    +

    Next we need to configure Radicale. We configure radicale to be accessible from other machines, how Radicale handles users and where the files should be stored. Open /etc/radicale/config with your favourite editor and add this configuration.

    [server]
     # Bind all addresses
     hosts = 0.0.0.0:5232, [::]:5232
    -- 
    cgit v1.2.3
    
    
    From 14094ed87cb2490c28eaf28937208987fa978296 Mon Sep 17 00:00:00 2001
    From: Mario Marhuenda 
    Date: Wed, 25 May 2022 12:46:35 +0200
    Subject: Usind md5 is insecure. Bcrypt is better
    
    ---
     radicale.html | 4 ++--
     1 file changed, 2 insertions(+), 2 deletions(-)
    
    (limited to 'radicale.html')
    
    diff --git a/radicale.html b/radicale.html
    index 029de7c..85bbf14 100644
    --- a/radicale.html
    +++ b/radicale.html
    @@ -26,14 +26,14 @@ hosts = 0.0.0.0:5232, [::]:5232
     [auth]
     type = htpasswd
     htpasswd_filename = /etc/radicale/users
    -htpasswd_encryption = md5
    +htpasswd_encryption = bcrypt
     
     [storage]
     filesystem_folder = /var/lib/radicale/collections

    As you can see under [auth] we use htpasswd to manage the users. Execute the following command to add a new user to Radicale.

    htpasswd -c /etc/radicale/users username
    -

    As Radicale stands now it is fully functional and after starting it by executing its binary, can be accessed under example.org:5232. But there are two additional things we can do to make using and managing Radicale way easier.

    +

    As Radicale stands now it is fully functional and after starting it by executing its binary, can be accessed under example.org:5232. But there are two additional things we can do to make using and managing Radicale way easier.

    Setting up a Nginx reverse proxy

    Because the URL of your Radicale server is an URL you will have to remember and enter it on any device you want to use your calendar on it is advised to set up a reverse proxy.

    server {
    -- 
    cgit v1.2.3