Note
Archived on 2026-10-22. Xandikos no longer runs from this Docker setup. It runs natively on a Raspberry Pi, managed by ansible in a private repository, with the same pinned image environment and the patches/sitecustomize.py dulwich fix carried over. This repository is kept read-only for reference: the troubleshooting notes in TROUBLESHOOTING.md still apply to any Xandikos with a git store.
Xandikos is a CalDAV/CardDAV server that I use for managing my contacts and calendar events. This repository contains the required configuration for using it.
First you need to have Docker installed and then run Xandikos with the provided docker-compsoe:
docker compose up -dAfter that it automatically creates required file structure, and you need to replace its bare repositories with your actual repositories:
cd user
cd contacts
rm -Rf .git
rm -Rf addressbook
git clone git@github.com:parham-alvani/addressbook
cd ..
cd calendars
rm -Rf .git
rm -Rf calendar
git clone git@github.com:parham-alvani/calendarAlso, you need to add the following information into your contacts/calendar git repository:
[user]
name = Parham Alvani
email = parham.alvani@gmail.comXandikos automatically creates commits and with this information you will have commits with your name and email address that can be pushed on GitHub without any issues.
For putting khal and khard into work when they configured to use another address as their repositories,
you can use the following symbolic links:
cd /home/parham/Documents/Git/parham/parham-alvani
rm -rf addressbook
rm -rf calendar
ln -s ~/Downloads/xandikos/user/contacts/addressbook addressbook
ln -s ~/Downloads/xandikos/user/calendars/calendar calendarmacOS required TLS for its CardDav account, so we need to support HTTPS over Xandikos. The main step here is to generate the certificate using the following command:
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 3650 -nodes -subj "/C=IR/ST=Tehran/L=Tehran/O=1995parham-me/OU=davx/CN=davx.infra.1995parham.me"See TROUBLESHOOTING.md — notably the fix for 500 on REPORT /
stuck DAVx5 sync (dulwich packfile concurrency bug; fix = convert the store to all-loose objects
and never git gc it).
