Skip to content
This repository was archived by the owner on Oct 22, 2026. It is now read-only.
1995parham-mePublic archive

About

Xandikos is a CalDAV/CardDAV server

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

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 in Action

Calendar and Contacts in Git without any 3rd-party services

logo

Introduction

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.

How to?

First you need to have Docker installed and then run Xandikos with the provided docker-compsoe:

docker compose up -d

After 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/calendar

Also, you need to add the following information into your contacts/calendar git repository:

[user]
  name = Parham Alvani
  email = parham.alvani@gmail.com

Xandikos 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.

Using it with khal and khard

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 calendar

Regenerate TLS Certificates

macOS 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"

Reference

Troubleshooting

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).

Repositories

About

Xandikos is a CalDAV/CardDAV server

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages