{"id":13442104,"url":"https://github.com/jelmer/xandikos","last_synced_at":"2026-04-10T01:01:38.342Z","repository":{"id":17094904,"uuid":"81122889","full_name":"jelmer/xandikos","owner":"jelmer","description":"A CalDAV/CardDAV server backed by Git","archived":false,"fork":false,"pushed_at":"2025-04-21T09:54:14.000Z","size":4522,"stargazers_count":473,"open_issues_count":63,"forks_count":43,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-21T10:49:25.786Z","etag":null,"topics":["caldav","carddav","dulwich","git","python","webdav"],"latest_commit_sha":null,"homepage":"https://www.xandikos.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jelmer.png","metadata":{"files":{"readme":"README.rst","changelog":"NEWS","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"jelmer"}},"created_at":"2017-02-06T19:22:26.000Z","updated_at":"2025-04-21T09:54:17.000Z","dependencies_parsed_at":"2023-11-07T18:26:51.105Z","dependency_job_id":"c7f349bf-2024-4b1b-9422-e66ffeb613f5","html_url":"https://github.com/jelmer/xandikos","commit_stats":{"total_commits":1257,"total_committers":31,"mean_commits":40.54838709677419,"dds":0.09466984884645979,"last_synced_commit":"f41ce18bda7b3b32d0b05f1721f061051f37c58e"},"previous_names":[],"tags_count":72,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jelmer%2Fxandikos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jelmer%2Fxandikos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jelmer%2Fxandikos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jelmer%2Fxandikos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jelmer","download_url":"https://codeload.github.com/jelmer/xandikos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254209859,"owners_count":22032897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["caldav","carddav","dulwich","git","python","webdav"],"created_at":"2024-07-31T03:01:41.738Z","updated_at":"2026-01-22T14:50:24.330Z","avatar_url":"https://github.com/jelmer.png","language":"Python","funding_links":["https://github.com/sponsors/jelmer"],"categories":["HarmonyOS","\u003ca id=\"tag-organization\" href=\"#tag-organization\"\u003eOrganization\u003c/a\u003e","Python","Software"],"sub_categories":["Windows Manager","Calendar \u0026 Contacts"],"readme":"Xandikos is a lightweight yet complete CardDAV/CalDAV server that backs onto a Git repository.\n\nXandikos (Ξανδικός or Ξανθικός) takes its name from the name of the March month\nin the ancient Macedonian calendar, used in Macedon in the first millennium BC.\n\n.. image:: logo.png\n   :alt: Xandikos logo\n   :width: 200px\n   :align: center\n\nExtended documentation can be found `on the home page \u003chttps://www.xandikos.org/docs/\u003e`_.\n\nImplemented standards\n=====================\n\nThe following standards are implemented:\n\n- :RFC:`4918`/:RFC:`2518` (Core WebDAV) - *implemented, except for LOCK operations (COPY/MOVE implemented for non-collections)*\n- :RFC:`4791` (CalDAV) - *fully implemented*\n- :RFC:`6352` (CardDAV) - *fully implemented*\n- :RFC:`5397` (Current Principal) - *fully implemented*\n- :RFC:`3253` (Versioning Extensions) - *partially implemented, only the REPORT method and {DAV:}expand-property property*\n- :RFC:`3744` (Access Control) - *partially implemented*\n- :RFC:`5995` (POST to create members) - *fully implemented*\n- :RFC:`5689` (Extended MKCOL) - *fully implemented*\n- :RFC:`6578` (Collection Synchronization for WebDAV) - *fully implemented*\n- :RFC:`7953` (Calendar Availability) - *fully implemented*\n\nThe following standards are not implemented:\n\n- :RFC:`6638` (CalDAV Scheduling Extensions) - *not implemented*\n- :RFC:`7809` (CalDAV Time Zone Extensions) - *not implemented*\n- :RFC:`7529` (WebDAV Quota) - *not implemented*\n- :RFC:`4709` (WebDAV Mount) - `intentionally \u003chttps://github.com/jelmer/xandikos/issues/48\u003e`_ *not implemented*\n- :RFC:`5546` (iCal iTIP) - *not implemented*\n- :RFC:`4324` (iCAL CAP) - *not implemented*\n\nSee `DAV compliance \u003cnotes/dav-compliance.rst\u003e`_ for more detail on specification compliance.\n\nLimitations\n-----------\n\n- No multi-user support\n\nSupported clients\n=================\n\nXandikos has been tested and works with the following CalDAV/CardDAV clients:\n\n- `Vdirsyncer \u003chttps://github.com/pimutils/vdirsyncer\u003e`_\n- `caldavzap \u003chttps://www.inf-it.com/open-source/clients/caldavzap/\u003e`_/`carddavmate \u003chttps://www.inf-it.com/open-source/clients/carddavmate/\u003e`_\n- `evolution \u003chttps://gitlab.gnome.org/GNOME/evolution/-/wikis/home\u003e`_\n- `DAVx5 \u003chttps://www.davx5.com/\u003e`_ (formerly DAVDroid)\n- `sogo connector for Icedove/Thunderbird \u003chttps://www.sogo.nu/download.html#/frontends\u003e`_\n- aCALdav syncer for Android\n- `pycardsyncer \u003chttps://github.com/geier/pycarddav\u003e`_\n- `akonadi \u003chttps://community.kde.org/KDE_PIM/Akonadi\u003e`_\n- `CalDAV-Sync \u003chttps://dmfs.org/caldav/\u003e`_\n- `CardDAV-Sync \u003chttps://dmfs.org/carddav/\u003e`_\n- `Calendarsync \u003chttps://play.google.com/store/apps/details?id=com.icalparse\u003e`_\n- `Tasks \u003chttps://tasks.org/\u003e`_\n- `AgendaV \u003chttps://github.com/agendav/agendav\u003e`_\n- `CardBook \u003chttps://gitlab.com/cardbook/cardbook/\u003e`_\n- Apple's iOS\n- `homeassistant's CalDAV integration \u003chttps://www.home-assistant.io/integrations/caldav/\u003e`_\n- `pimsync \u003chttps://pimsync.whynothugo.nl/\u003e`_\n- `davcli \u003chttps://git.sr.ht/~whynothugo/davcli\u003e`_\n- `Thunderbird \u003chttps://www.thunderbird.net/\u003e`_\n\nDependencies\n============\n\nAt the moment, Xandikos supports Python 3 (see pyproject.toml for specific version)\nas well as Pypy 3. It also uses `Dulwich \u003chttps://github.com/dulwich/dulwich\u003e`_,\n`Jinja2 \u003chttp://jinja.pocoo.org/\u003e`_,\n`icalendar \u003chttps://github.com/collective/icalendar\u003e`_, and\n`defusedxml \u003chttps://github.com/tiran/defusedxml\u003e`_.\n\nE.g. to install those dependencies on Debian:\n\n.. code:: shell\n\n  sudo apt install python3-dulwich python3-defusedxml python3-icalendar python3-jinja2\n\nOr to install them using pip:\n\n.. code:: shell\n\n  python setup.py develop\n\nContainer\n---------\n\nA Containerfile is also provided; see the comments on the top of the file for\nconfiguration instructions. The container image is regularly built and\npublished at ``ghcr.io/jelmer/xandikos``. For each release,\na ``v$RELEASE`` tag is available - e.g. ``v0.2.11`` for release *0.2.11*.\nFor a full list, see `the Container overview page\n\u003chttps://github.com/jelmer/xandikos/pkgs/container/xandikos\u003e`_.\n\nThe container image can be configured using environment variables:\n\n- ``PORT`` - Port to listen on (default: 8000)\n- ``METRICS_PORT`` - Port for metrics endpoint (default: 8001)\n- ``LISTEN_ADDRESS`` - Address to bind to (default: 0.0.0.0)\n- ``DATA_DIR`` - Data directory path (default: /data)\n- ``CURRENT_USER_PRINCIPAL`` - User principal path (default: /user/)\n- ``ROUTE_PREFIX`` - URL route prefix (default: /)\n- ``AUTOCREATE`` - Auto-create directories (true/false)\n- ``DEFAULTS`` - Create default calendar/addressbook (true/false)\n- ``DEBUG`` - Enable debug logging (true/false)\n- ``DUMP_DAV_XML`` - Print DAV XML requests/responses (true/false)\n- ``NO_STRICT`` - Enable client compatibility workarounds (true/false)\n\nSee ``examples/docker-compose.yml`` and the\n`man page \u003chttps://www.xandikos.org/manpage.html\u003e`_ for more info.\n\nRunning\n=======\n\nXandikos can either directly listen on a plain HTTP socket, or it can sit\nbehind a reverse HTTP proxy.\n\nTesting\n-------\n\nTo run a standalone (no authentication) instance of Xandikos,\nwith a pre-created calendar and addressbook (storing data in *$HOME/dav*):\n\n.. code:: shell\n\n  ./bin/xandikos --defaults -d $HOME/dav\n\nA server should now be listening on `localhost:8080 \u003chttp://localhost:8080/\u003e`_.\n\nNote that Xandikos does not create any collections unless --defaults is\nspecified. You can also either create collections from your CalDAV/CardDAV client,\nor by creating git repositories under the *contacts* or *calendars* directories\nit has created.\n\nProduction\n----------\n\nThe easiest way to run Xandikos in production is by running a reverse HTTP proxy\nlike Apache or nginx in front of it.\nThe xandikos script can either listen on the local host on a particular port, or\nit can listen on a unix domain socket.\n\n\nFor example init system configurations, see examples/.\n\nClient instructions\n===================\n\nSome clients can automatically discover the calendars and addressbook URLs from\na DAV server (if they support RFC:`5397`). For such clients you can simply\nprovide the base URL to Xandikos during setup.\n\nClients that lack such automated discovery require the direct URL to a calendar\nor addressbook. In this case you should provide the full URL to the calendar or\naddressbook; if you initialized Xandikos using the ``--defaults`` argument\nmentioned in the previous section, these URLs will look something like this::\n\n  http://dav.example.com/user/calendars/calendar\n\n  http://dav.example.com/user/contacts/addressbook\n\n\nContributing\n============\n\nContributions to Xandikos are very welcome. If you run into bugs or have\nfeature requests, please file issues `on GitHub\n\u003chttps://github.com/jelmer/xandikos/issues/new\u003e`_. If you're interested in\ncontributing code or documentation, please read `CONTRIBUTING\n\u003cCONTRIBUTING.md\u003e`_. Issues that are good for new contributors are tagged\n`new-contributor \u003chttps://github.com/jelmer/xandikos/labels/new-contributor\u003e`_\non GitHub.\n\nHelp\n====\n\nThere is a *#xandikos* IRC channel on the `OFTC \u003chttps://www.oftc.net/\u003e`_\nIRC network, and a `Xandikos \u003chttps://groups.google.com/forum/#!forum/xandikos\u003e`_\nmailing list.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjelmer%2Fxandikos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjelmer%2Fxandikos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjelmer%2Fxandikos/lists"}