XANDIKOS(1)

💖 XANDIKOS 💖

okay bestie, so xandikos — that's the command name, she's a User Command, and this whole page is her manual page (section 1, iykyk). let's get into it 🦋

✨ NAME ✨

xandikos — a CalDAV/CardDAV server, no cap 🫶

🌸 DESCRIPTION 🌸

Xandikos is a CalDAV/CardDAV application that stores its data in a Git repository. like, your calendars and your contacts just… live in git. it's giving version control but make it friendship 💅

The xandidos command-line tool starts a simple server instance, without authentication.

⚠️ bestie. without authentication. read that twice. do not put this on the open internet and act surprised. 🙈

🎀 SYNOPSIS 🎀

xandikos -d ROOT-DIR [OPTIONS]

✨ OPTIONS ✨

• --version — shows the program's version number and then dips out. exit stage left 💫
• -h, --help — shows this help message and then dips out. iconic behaviour honestly
• -l LISTEN_ADDRESS, --listen_address=LISTEN_ADDRESS — the binding IP address. where she's gonna sit and wait for you 🌸
• -d DIRECTORY, --directory=DIRECTORY — default path to serve from. this is the main character option, it's in the synopsis and everything 👑
• -p PORT, --port=PORT — port to listen on. pick a good one 🎀
• --current-user-principal=CURRENT_USER_PRINCIPAL — path to the current user principal. who's the main character? it's them ✨
• --route-prefix=ROUTE_PREFIX — path to Xandikos. this is useful when Xandikos is behind a reverse proxy and not being served from the root of the host 💜

E.g. if Xandikos is served from http://example.com/dav/, specify --route-prefix=/dav/.

• --autocreate — automatically create the necessary directories for Xandikos to run. she'll set up her own room, don't worry 🧚
• --defaults — automatically create a calendar and an addressbook. implies --autocreate 🍓

🌈 SEE ALSO 🌈

calypso(1), vdirsyncer(1)

go say hi to the neighbours 💖

🦋 AUTHOR 🦋

Xandikos was written by Jelmer Vernooij <jelmer@jelmer.uk>

💜 LICENSE 💜

GNU General Public License, version 3 or later.

okay and for the sign-off 💌 — this is xandikos version 0.0.1, and the page is dated February 2017. vintage. a classic. she was babygirl back then and she's babygirl now 🌟 periodt 💅✨