xandikos8
Git-backed caldav/carddav server
Overview
usage: ./bin/xandikos -d ROOT-DIR [OPTIONS]
optional arguments:
-
-h, --help -
show this help message and exit
-
--version -
show program's version number and exit
-
-d DIRECTORY, --directory DIRECTORY -
Directory to serve from.
-
--current-user-principal CURRENT_USER_PRINCIPAL -
Path to current user principal. [/user/]
-
--autocreate -
Automatically create necessary directories.
-
--defaults -
Create initial calendar and address book. Implies
--autocreate.
-
--dump-dav-xml -
Print DAV XML request/responses.
-
--avahi -
Announce services with avahi.
-
--no-strict -
Enable workarounds for buggy CalDAV/CardDAV client implementations.
Access Options:
-
-l LISTEN_ADDRESS, --listen-address LISTEN_ADDRESS -
Bind to this address. Pass in path for unix domain socket. [localhost]
-
-p PORT, --port PORT -
Port to listen on. [8080]
-
--route-prefix ROUTE_PREFIX -
Path to Xandikos. (useful when Xandikos is behind a reverse proxy) [/]
-
--autocert -
Serve HTTPS using a self-signed certificate, generating one under ~/.local/share/xandikos/certs if missing. For development and testing only — do not use in production. Run Xandikos behind a reverse proxy with a real CA-issued certificate instead.
-
--htpasswd FILE -
Require HTTP Basic authentication, validating credentials against an Apache-style htpasswd file. Supports bcrypt (htpasswd -B, recommended) and SHA1 entries. Requires
--autocert; Basic auth must not be served over plain HTTP. If Xandikos is behind a reverse proxy, configure authentication there instead.
Releases
2 releases since Debian 12 (Bookworm); the text changed 1 time.
--autocert since Arch Linux 2026-11-01;
--htpasswd since Arch Linux 2026-11-01.