From 9cb5ffe8a5e2746805a31f25491e657700e34221 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E1=93=B0=E1=95=B5=E1=95=B5=E1=93=8D?=
 <52239579+ippocratis@users.noreply.github.com>
Date: Tue, 7 Mar 2023 23:53:32 +0200
Subject: [PATCH] radicale (#18)

* Create contacts-calendar

Add new category

* Delete contacts-calendar

* Create Baikal.md

* Delete Baikal.md

* Create baikal.md

* Update README.md

* Create radicale.md

Added radicals to contats/calendars

* Update README.md

Added radicale

* Update radicale.md

* Update radicale.md

Replaced dots with actual spaces
---
 README.md                           |  2 +-
 apps/contacts-calendars/radicale.md | 66 +++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+), 1 deletion(-)
 create mode 100644 apps/contacts-calendars/radicale.md

diff --git a/README.md b/README.md
index 67ff326..3d775ab 100644
--- a/README.md
+++ b/README.md
@@ -106,7 +106,7 @@ The aims is to provide a ready-to-run recipes that you can just copy, paste and
 
 # Contacts - calendars
 - [Baikal](apps/contacts-calendars/baikal.md)
-
+- [Radicale](apps/contacts-calendars/radicale.md)
 
 # Cookbook
 - [NextCloud Cookbook](https://apps.nextcloud.com/apps/cookbook) 🔗 - quite good. Can import from URL (some pages), but manually editing longer recipes is a bit of a pain (you need to add and paste every single ingredient & preparation step one-by-one).
diff --git a/apps/contacts-calendars/radicale.md b/apps/contacts-calendars/radicale.md
new file mode 100644
index 0000000..f73d897
--- /dev/null
+++ b/apps/contacts-calendars/radicale.md
@@ -0,0 +1,66 @@
+# docker-radicale
+
+Radicale is a small but powerful CalDAV (calendars, to-do lists) and CardDAV (contacts) server
+
+<br>
+
+- [Github repo](https://github.com/tomsquest/docker-radicale)
+
+- [configuration file](https://github.com/tomsquest/docker-radicale/blob/master/config)
+
+
+```yml
+services:
+  radicale:
+    image: tomsquest/docker-radicale
+    container_name: radicale
+    ports:
+      - 5232:5232
+    init: true
+    read_only: true
+    security_opt:
+      - no-new-privileges:true
+    healthcheck:
+      test: curl -f http://127.0.0.1:5232 || exit 1
+      interval: 30s
+      retries: 3
+    restart: unless-stopped
+    volumes:
+      - ./data:/data
+      - ./config:/config:ro
+      - ./users:/etc/radicale/users
+```
+
+## Tips & tricks
+
+### configuration file
+
+create a config directory in the working dir
+
+`mkdir -p config`
+
+copy the configuration file from the link above into the config folder 
+
+
+### Basic auth
+
+Uncomment/Enable the following in the configuration file
+
+ ```
+[auth]
+type = htpasswd
+htpasswd_filename = /etc/radicale/users
+htpasswd_encryption = md5
+```
+
+### htpasswd
+
+flat-file used to store usernames and password for basic authentication 
+
+While in the working dir
+
+```
+htpasswd -c users username
+New password:
+Re-type new password:
+```