History of Radicale Cribsheet
<h2>Radicale CalDAV/CardDAV Server - Key Points</h2>
<h3>Installing</h3>
<p><code>zypper install radicale # Creates radicale:radicale system user automatically </code></p>
<h3>Configuration `/etc/radicale/config`</h3>
<p>Key active settings:</p>
<p>{code}[server] hosts = localhost:5232 [auth] type = htpasswd htpasswd_filename = /etc/radicale/users htpasswd_encryption = autodetect [storage] filesystem_folder = /srv/radicale/collections {/code}</p>
<h3>Critical systemd override</h3>
<p>Default service restricts writes to `/var/lib/radicale/` — must add `/srv/radicale/` to allowed paths. Copy service file to webstack and add:</p>
<pre>
&lt;code&gt;ReadWritePaths=/var/lib/radicale/collections /srv/radicale/
&lt;/code&gt;</pre>
<h3>Storage setup</h3>
<pre>
&lt;code&gt;mkdir -p /srv/radicale/collections
chown -R radicale:radicale /srv/radicale
chmod 755 /srv/radicale
chmod 755 /srv/radicale/collections
&lt;/code&gt;</pre>
<p>**Critical — directories need 755 not 644!**</p>
<h3>Collection structure</h3>
<pre>
&lt;code&gt;# Create directory structure
mkdir -p /srv/radicale/collections/collection-root/lsces/calendar
mkdir -p /srv/radicale/collections/collection-root/lsces/contacts
# Props files &amp;mdash; collection-root needs one too!
echo &amp;#39;{}&amp;#39; &amp;gt; /srv/radicale/collections/collection-root/.Radicale.props
cat &amp;gt; /srv/radicale/collections/collection-root/lsces/.Radicale.props &amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
{&amp;quot;D:displayname&amp;quot;: &amp;quot;lsces&amp;quot;}
EOF
cat &amp;gt; /srv/radicale/collections/collection-root/lsces/calendar/.Radicale.props &amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
{&amp;quot;C:supported-calendar-component-set&amp;quot;: &amp;quot;VEVENT,VJOURNAL,VTODO&amp;quot;, &amp;quot;D:displayname&amp;quot;: &amp;quot;Personal Calendar&amp;quot;, &amp;quot;tag&amp;quot;: &amp;quot;VCALENDAR&amp;quot;}
EOF
cat &amp;gt; /srv/radicale/collections/collection-root/lsces/contacts/.Radicale.props &amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
{&amp;quot;D:displayname&amp;quot;: &amp;quot;Personal Contacts&amp;quot;, &amp;quot;tag&amp;quot;: &amp;quot;VADDRESSBOOK&amp;quot;}
EOF
chown -R radicale:radicale /srv/radicale/collections
&lt;/code&gt;</pre>
<h3>Create user</h3>
<pre>
&lt;code&gt;htpasswd -B -c /etc/radicale/users lsces
&lt;/code&gt;</pre>
<h3>Enable and start</h3>
<pre>
&lt;code&gt;systemctl daemon-reload
systemctl enable radicale
systemctl start radicale
systemctl status radicale
&lt;/code&gt;</pre>
<h3>nginx reverse proxy</h3>
<pre>
&lt;code&gt;location /dav/ {
proxy_pass http://localhost:5232/;
proxy_set_header X-Script-Name /dav;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_pass_header Authorization;
proxy_set_header Authorization $http_authorization;
}
&lt;/code&gt;</pre>
<p>**Both Authorization headers needed — nginx strips it without explicit passthrough!**</p>
<h3>Migrating from Nextcloud</h3>
<p>**Calendar export** — Nextcloud UI: Calendar → Edit → Export → saves `.ics` Radicale requires **one event per file** — split the export:</p>
<pre>
&lt;code&gt;import re, os
with open(&amp;#39;personal.ics&amp;#39;, &amp;#39;r&amp;#39;) as f:
content = f.read()
header = content[:content.index(&amp;#39;BEGIN:VEVENT&amp;#39;)]
footer = &amp;#39;END:VCALENDARn&amp;#39;
events = re.findall(&amp;#39;BEGIN:VEVENT.*?END:VEVENT&amp;#39;, content, re.DOTALL)
os.makedirs(&amp;#39;/srv/radicale/split&amp;#39;, exist_ok=True)
for event in events:
uid = re.search(&amp;#39;UID:(.*?)n&amp;#39;, event).group(1).strip()
with open(f&amp;#39;/srv/radicale/split/{uid}.ics&amp;#39;, &amp;#39;w&amp;#39;) as f:
f.write(header)
f.write(event + &amp;#39;n&amp;#39;)
f.write(footer)
print(f&amp;#39;Split {len(events)} events&amp;#39;)
&lt;/code&gt;</pre>
<p>**Contacts export** — Nextcloud UI: Contacts → Settings → Export → saves `.vcf` Same split needed for contacts:</p>
<pre>
&lt;code&gt;import re, os
with open(&amp;#39;contacts.vcf&amp;#39;, &amp;#39;r&amp;#39;) as f:
content = f.read()
contacts = re.findall(&amp;#39;BEGIN:VCARD.*?END:VCARD&amp;#39;, content, re.DOTALL)
os.makedirs(&amp;#39;/srv/radicale/split_contacts&amp;#39;, exist_ok=True)
for contact in contacts:
uid = re.search(&amp;#39;UID:(.*?)n&amp;#39;, contact)
uid = uid.group(1).strip() if uid else f&amp;#39;contact_{contacts.index(contact)}&amp;#39;
with open(f&amp;#39;/srv/radicale/split_contacts/{uid}.vcf&amp;#39;, &amp;#39;w&amp;#39;) as f:
f.write(contact + &amp;#39;n&amp;#39;)
print(f&amp;#39;Split {len(contacts)} contacts&amp;#39;)
&lt;/code&gt;</pre>
<p>**Import via curl:**</p>
<pre>
&lt;code&gt;# Calendar events
for f in /srv/radicale/split/*.ics; do
uid=$(basename &amp;quot;$f&amp;quot; .ics)
curl -s -u lsces:password
-X PUT
-H &amp;quot;Content-Type: text/calendar&amp;quot;
--data-binary @&amp;quot;$f&amp;quot;
&amp;quot;https://rdm1.uk/dav/lsces/calendar/${uid}.ics&amp;quot;
echo &amp;quot;$uid&amp;quot;
done
# Contacts
for f in /srv/radicale/split_contacts/*.vcf; do
uid=$(basename &amp;quot;$f&amp;quot; .vcf)
curl -s -u lsces:password
-X PUT
-H &amp;quot;Content-Type: text/vcard&amp;quot;
--data-binary @&amp;quot;$f&amp;quot;
&amp;quot;https://rdm1.uk/dav/lsces/contacts/${uid}.vcf&amp;quot;
echo &amp;quot;$uid&amp;quot;
done
&lt;/code&gt;</pre>
<h3>Client configuration</h3>
<p>**Thunderbird** — Add new calendar/contacts: - Network → CalDAV/CardDAV - URL: `https://yourdomain/dav/username/calendar/` **DAVx⁵ (Android)** — Add account: - Base URL: `https://yourdomain/dav/username/` - Auto-discovers both calendar and contacts</p>
<h3>Installing</h3>
<p><code>zypper install radicale # Creates radicale:radicale system user automatically </code></p>
<h3>Configuration `/etc/radicale/config`</h3>
<p>Key active settings:</p>
<p>{code}[server] hosts = localhost:5232 [auth] type = htpasswd htpasswd_filename = /etc/radicale/users htpasswd_encryption = autodetect [storage] filesystem_folder = /srv/radicale/collections {/code}</p>
<h3>Critical systemd override</h3>
<p>Default service restricts writes to `/var/lib/radicale/` — must add `/srv/radicale/` to allowed paths. Copy service file to webstack and add:</p>
<pre>
&lt;code&gt;ReadWritePaths=/var/lib/radicale/collections /srv/radicale/
&lt;/code&gt;</pre>
<h3>Storage setup</h3>
<pre>
&lt;code&gt;mkdir -p /srv/radicale/collections
chown -R radicale:radicale /srv/radicale
chmod 755 /srv/radicale
chmod 755 /srv/radicale/collections
&lt;/code&gt;</pre>
<p>**Critical — directories need 755 not 644!**</p>
<h3>Collection structure</h3>
<pre>
&lt;code&gt;# Create directory structure
mkdir -p /srv/radicale/collections/collection-root/lsces/calendar
mkdir -p /srv/radicale/collections/collection-root/lsces/contacts
# Props files &amp;mdash; collection-root needs one too!
echo &amp;#39;{}&amp;#39; &amp;gt; /srv/radicale/collections/collection-root/.Radicale.props
cat &amp;gt; /srv/radicale/collections/collection-root/lsces/.Radicale.props &amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
{&amp;quot;D:displayname&amp;quot;: &amp;quot;lsces&amp;quot;}
EOF
cat &amp;gt; /srv/radicale/collections/collection-root/lsces/calendar/.Radicale.props &amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
{&amp;quot;C:supported-calendar-component-set&amp;quot;: &amp;quot;VEVENT,VJOURNAL,VTODO&amp;quot;, &amp;quot;D:displayname&amp;quot;: &amp;quot;Personal Calendar&amp;quot;, &amp;quot;tag&amp;quot;: &amp;quot;VCALENDAR&amp;quot;}
EOF
cat &amp;gt; /srv/radicale/collections/collection-root/lsces/contacts/.Radicale.props &amp;lt;&amp;lt; &amp;#39;EOF&amp;#39;
{&amp;quot;D:displayname&amp;quot;: &amp;quot;Personal Contacts&amp;quot;, &amp;quot;tag&amp;quot;: &amp;quot;VADDRESSBOOK&amp;quot;}
EOF
chown -R radicale:radicale /srv/radicale/collections
&lt;/code&gt;</pre>
<h3>Create user</h3>
<pre>
&lt;code&gt;htpasswd -B -c /etc/radicale/users lsces
&lt;/code&gt;</pre>
<h3>Enable and start</h3>
<pre>
&lt;code&gt;systemctl daemon-reload
systemctl enable radicale
systemctl start radicale
systemctl status radicale
&lt;/code&gt;</pre>
<h3>nginx reverse proxy</h3>
<pre>
&lt;code&gt;location /dav/ {
proxy_pass http://localhost:5232/;
proxy_set_header X-Script-Name /dav;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_pass_header Authorization;
proxy_set_header Authorization $http_authorization;
}
&lt;/code&gt;</pre>
<p>**Both Authorization headers needed — nginx strips it without explicit passthrough!**</p>
<h3>Migrating from Nextcloud</h3>
<p>**Calendar export** — Nextcloud UI: Calendar → Edit → Export → saves `.ics` Radicale requires **one event per file** — split the export:</p>
<pre>
&lt;code&gt;import re, os
with open(&amp;#39;personal.ics&amp;#39;, &amp;#39;r&amp;#39;) as f:
content = f.read()
header = content[:content.index(&amp;#39;BEGIN:VEVENT&amp;#39;)]
footer = &amp;#39;END:VCALENDARn&amp;#39;
events = re.findall(&amp;#39;BEGIN:VEVENT.*?END:VEVENT&amp;#39;, content, re.DOTALL)
os.makedirs(&amp;#39;/srv/radicale/split&amp;#39;, exist_ok=True)
for event in events:
uid = re.search(&amp;#39;UID:(.*?)n&amp;#39;, event).group(1).strip()
with open(f&amp;#39;/srv/radicale/split/{uid}.ics&amp;#39;, &amp;#39;w&amp;#39;) as f:
f.write(header)
f.write(event + &amp;#39;n&amp;#39;)
f.write(footer)
print(f&amp;#39;Split {len(events)} events&amp;#39;)
&lt;/code&gt;</pre>
<p>**Contacts export** — Nextcloud UI: Contacts → Settings → Export → saves `.vcf` Same split needed for contacts:</p>
<pre>
&lt;code&gt;import re, os
with open(&amp;#39;contacts.vcf&amp;#39;, &amp;#39;r&amp;#39;) as f:
content = f.read()
contacts = re.findall(&amp;#39;BEGIN:VCARD.*?END:VCARD&amp;#39;, content, re.DOTALL)
os.makedirs(&amp;#39;/srv/radicale/split_contacts&amp;#39;, exist_ok=True)
for contact in contacts:
uid = re.search(&amp;#39;UID:(.*?)n&amp;#39;, contact)
uid = uid.group(1).strip() if uid else f&amp;#39;contact_{contacts.index(contact)}&amp;#39;
with open(f&amp;#39;/srv/radicale/split_contacts/{uid}.vcf&amp;#39;, &amp;#39;w&amp;#39;) as f:
f.write(contact + &amp;#39;n&amp;#39;)
print(f&amp;#39;Split {len(contacts)} contacts&amp;#39;)
&lt;/code&gt;</pre>
<p>**Import via curl:**</p>
<pre>
&lt;code&gt;# Calendar events
for f in /srv/radicale/split/*.ics; do
uid=$(basename &amp;quot;$f&amp;quot; .ics)
curl -s -u lsces:password
-X PUT
-H &amp;quot;Content-Type: text/calendar&amp;quot;
--data-binary @&amp;quot;$f&amp;quot;
&amp;quot;https://rdm1.uk/dav/lsces/calendar/${uid}.ics&amp;quot;
echo &amp;quot;$uid&amp;quot;
done
# Contacts
for f in /srv/radicale/split_contacts/*.vcf; do
uid=$(basename &amp;quot;$f&amp;quot; .vcf)
curl -s -u lsces:password
-X PUT
-H &amp;quot;Content-Type: text/vcard&amp;quot;
--data-binary @&amp;quot;$f&amp;quot;
&amp;quot;https://rdm1.uk/dav/lsces/contacts/${uid}.vcf&amp;quot;
echo &amp;quot;$uid&amp;quot;
done
&lt;/code&gt;</pre>
<h3>Client configuration</h3>
<p>**Thunderbird** — Add new calendar/contacts: - Network → CalDAV/CardDAV - URL: `https://yourdomain/dav/username/calendar/` **DAVx⁵ (Android)** — Add account: - Base URL: `https://yourdomain/dav/username/` - Auto-discovers both calendar and contacts</p>