USE.md



Calendaring introduction
Anyone can read calendars shared publicly at Example orga.
Your personal [[account]] grants read-only access to closed-group shared calendars.
Custom group accounts provide write access to (closed-group or public) shared calendars.
Special strings
NB! This documentation uses special strings
which you may want to adapt for your local setup:
organisation: Example orga
eventhost: event.example.org
Clients
Recommended calendaring client depends on the operating system you use:

Mac, iPhone and iPad: Apple Calendar
Windows and Linux: Mozilla Thunderbird
Android: DAVdroid
and ICSdroid

Read-only access
When you only need to read a calendar,
the best (most efficient) is to subscribe to an iCal calender:

Copy address of relevant calendar from web page
http://event.example.org/.
Open calendaring client, and add new account profile of type "ical".
Paste the calendar address as server address.

Closed-group calendars also require username and password,
and require a secure connection (TLS or SSL, or "https://" address).
Read-write access
To both read a calendar and help maintain its content,
you need to setup a CalDAV profile:

Open calendaring client, and add new account profile of type "CalDAV".
Server address: event.example.org
Username and password: Either personal or calendar-group account credentials.

If above fails, or if you want to specifically pick a single calender,
use this alternative approach:

Copy address of relevant calendar from web page
https://event.example.org/

(replace USERNAME with either personal or calendar-group account name)
Open calendaring client, and add new account profile of type "CalDAV".
Paste the calendar address as server address.