Git Product home page Git Product logo

carldav's Introduction

carldav

A lightweight CalDAV and CardDAV server for personal use powered by Spring Boot.

Supported clients

So far caldav has been tested with the following clients:

Installation

Dependencies

  • Java 17

Build and package

  • run ./mvnw package or mvnw.cmd on Windows
  • you will find a fat jar (Spring Boot application) int the target folder
  • run java -jar target/carldav.jar

Configuration

If not specified carldav will create a random admin password on every startup. Generated admin password can be found in the logs: 19:08:41.678 [main] INFO carldav.bootstrap.AdminUserCreator - admin user 'root@localhost:test'

If you want to set your own persistent admin password create config/application.properties file in the same directory as carldav.jar. Add carldav.admin.password with your desired password to application.properties, for example.: carldav.admin.password=4b033fad-db09-4aa3-852b-87aa2b2598ea

Admin user name is set to root@localhost. You can change it with the property carldav.admin.name.

Add a user

In the current state of development caldav doesn't support a web ui. Therefore you'll need to issue a HTTP request by hand in order to create a user. For example:

curl -i --user root@localhost:4b033fad-db09-4aa3-852b-87aa2b2598ea -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d '{"email": "you@localhost", "password": "password"}' http://localhost:1984/carldav/user

Connect your client to carldav

  • Mozilla Thunderbird with TbSync: set CalDAV and CardDAV server address to http://localhost:1984/carldav/dav/you@localhost/calendar. Contact sync will be configured automatically.
  • Evolution: set CalDAV server address to http://localhost:1984/carldav/dav/you@localhost/calendar and CardDAV server address to http://localhost:1984/carldav/dav/you@localhost/contacts. In addition, you can use VJOURNAL calendar entries (Evolution Memo) as defined in RFC 4791.
  • Android: Set CalDAV and CardDAV server address to http://localhost:1984/carldav/dav/you@localhost/calendar. Contact sync will be configured automatically.
  • iOS: ehm, you know it.

Constrains

  • caldav doesn't support additional CalDAV resources yet
  • caldav doesn't support additional CardDAV resources yet
  • caldav doesn't fully comply with various RFC's regarding CalDAV/CardDAV
  • caldav doesn't support calendar sharing yet

Help needed

  • Testing on different clients and platforms, especially iOS

carldav's People

Contributors

corneliudobrota avatar eisler avatar jhermann avatar ksokol avatar wsdwl avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.