xandikos(8)

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.

  1. 12
  2. Arch

--autocert since Arch Linux 2026-11-01; --htpasswd since Arch Linux 2026-11-01.

Authors

Jelmer Vernooij <[email protected]>

From xandikos 0.4.10-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.