RustiCal

a CalDAV/CardDAV server

Caution

RustiCal is not production-ready! There can be changes to the database without migrations and there's no guarantee that all endpoints are secured yet. If you still want to play around with it in its current state, absolutely feel free to do so but know that not even I use it productively yet.

Installation

Manual

cargo install --git https://github.com/lennart-k/rustical

Docker

docker run \
  -p 4000:4000 \
  -v YOUR_DATA_DIR:/var/lib/rustical/ \
  -v YOUR_CONFIG_TOML:/etc/rustical/config.toml \
  ghcr.io/lennart-k/rustical

Configuration

You can generate a default config.toml with

rustical gen-config

You'll have to set your database path to something like /var/lib/rustical/db.sqlite3. There you also set your username, password, and app tokens. Password hashes can be generated with

rustical pwhash

Docker

You can also run the upper commands in Docker with

docker run --rm ghcr.io/lennart-k/rustical gen-config
docker run -it --rm ghcr.io/lennart-k/rustical pwhash

Password vs app tokens

The password is meant as a password you use to log in to the frontend. Since it's sensitive information, the secure but slow hash algorithm argon2 is chosen.

I recommend to generate random app tokens for each CalDAV/CardDAV client. These can use the faster pbkdf2 algorithm.

Relevant RFCs

• Versioning Extensions to WebDAV: RFC 3253
  • provides the REPORT method
• Calendaring Extensions to WebDAV (CalDAV): RFC 4791
• Scheduling Extensions to CalDAV: RFC 6638
  • not sure yet whether to implement this
• Collection Synchronization WebDAV RFC 6578
  • We need to implement sync-token, etc.
  • This is important for more efficient synchronisation
• iCalendar RFC 2445