[[CalDAV-Sync]] and [[CardDAV-Sync]] support auto-configuration and painless account setup. This is particular useful if you run a CalDAV/CardDAV server for an organization with many users. Auto-configuration allows users to set up the account without knowledge of any server details (and without all the typing).
+
[[CalDAV-Sync]] and [[CardDAV-Sync]] support auto-provisioning for painless account setup. This is particular useful if you run a CalDAV/CardDAV server for an organization with many users. Auto-provisioning allows users to set up the account without knowledge of any server details (and without all the typing).
Auto-configuration is still under development. Future releases will allow to set more options automatically up to a degree where almost no additional user-interaction is necessary.
+
Auto-provisioning is still under development. Future releases will allow to set more options automatically up to a degree where almost no additional user-interaction is necessary.
    
== How it works ==
 
== How it works ==
   −
To use auto-configuration place a link matching this scheme on your website:
+
To use auto-provisioning place a link matching this scheme on your website, in an email, an SMS, or in a QR code (see [[#QR codes|QR codes]]):
 
<pre>
 
<pre>
 
caldav[s]://[username[:password]@][servename][:port][/path][#options]
 
caldav[s]://[username[:password]@][servename][:port][/path][#options]
       +
=== Encoding example ===
   −
Use the following to sync using SSL (with an alternative SSL-port), preemptive authentication and enforced DTEND. The login in this example is username@example.com (note the encoded "@")
+
Special care has to be taken when user names (and passwords) contain special characters that have to be encoded in ULRs. Use the following to sync using SSL (with an alternative SSL-port), preemptive authentication and enforced DTEND. The login in this example is username@example.com (note the encoded "@")
 
: caldavs://username%40example.com@example.com:8443#preemptive_auth&enforce_dtend
 
: caldavs://username%40example.com@example.com:8443#preemptive_auth&enforce_dtend
 +
 +
=== QR codes ===
 +
 +
You can place the auto-provisioning link in a QR code for even more convenient setup (try to scan the image on the right). [[File:sogo-caldav.png‎|right|thumb|150px|this QR code will set up an account for SOGo]]
 +
 +
With an online QR generator (e.g. http://goqr.me/) you can even create the codes dynamically like in this example: http://api.qrserver.com/v1/create-qr-code/?data=caldav%3A%2F%2Fsogo1%40sogo-demo.inverse.ca&size=255x255
 +
 +
Please note that neither CalDAV-Sync nor CardDAV-Sync provide a QR code scanner, but any available scanner at Google Play should work well.
 +
 +
Thanks to "Rhapsodhy" for the QR code idea!
    
== Use it locally ==
 
== Use it locally ==