event/intro.mdwn



Calendaring introduction
Anyone can read calendars shared publicly at [[!template id=realm]].
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.
Clients
Recommended calendaring client depends on the operating system you use:

Mac, iPhone and iPad: Apple Calendar
Windows and Linux: Mozilla Lightning
Android: DavDroid

Security
Before you setup any password-protected calendars,
make sure to install the CACert.org security certificate.
Read-only access
When you only need to read a calendar,
then the best (most efficient) is to subscribe to an "iCal" calender:

Go to web page http://[[!template id=eventhost]]/
Copy address of relevant calendar.
Open calendaring client, and add new account profile.
Request creation of a new "ical" profile
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" (a.k.a. "on the network").
Server address: [[!template id=eventhost]]:8443
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:

Go to web page https://[[!template id=eventhost]]:8443/calendars/users/USERNAME/

(replace USERNAME with either personal or calendar-group account name)
Copy address for relevant calendar (a.k.a. "Collection").
Open calendaring client, and add new account profile of type "CalDAV" (a.k.a. "on the network").
Server address: Paste the calendar selected previously.