---
name: "xandikos"
section: "8"
platform: "linux"
package: "xandikos"
version: "0.4.10-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xandikos/8"
---

# xandikos(8)

git-backed CalDAV/CardDAV server

## NAME

xandikos - git-backed CalDAV/CardDAV server

## DESCRIPTION

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.

## AUTHORS

Jelmer Vernooij \<jelmer@debian.org\>