Configuration

From ACal Wiki

Jump to: navigation, search
Help
Available languages
EnglishFrançais

aCal is a CalDAV client. It is not useful unless you have a CalDAV server available.

This page is mostly about configuring a server. Information about other configurable things in aCal is under Configuring Calendars & Addressbooks or Preference Settings.

Contents

Adding a Server

Once you have your CalDAV server available you can try and point aCal at it. From version 1.5, when you first start aCal it will prompt you for the details needed to create a new server.

If you skip that screen, or you are using an older version, you should press the Android "menu" button and choose "Settings" then "Servers" and finally "Add Server". Choose one of the saved configurations or presets if applicable, otherwise just press "Manual Configuration".

Simple Settings

Username: The username you have been given for the site.
Password: Your password.
User URL: A URL for the server. For a capable server this might be as simple as entering in the domain name, especially if the server supports RFC5785, which is pretty simple for a server administrator to do.

When you save these settings aCal will try and connect to your server and discover your calendars and addressbooks.

More about the Server URL

Sometimes the User URLs are hidden away in places like server.domain.com/dav/, and some CalDAV servers (e.g. Yahoo) don't support trivial extensions like RFC5397 so you will need to explicitly enter a long complex URL in this field. The URL which aCal is trying to find is called the "Principal URL" - it's sort of your "home directory" on the server. Once aCal knows that it can find all of your calendars and addressbooks from there.

aCal will try and work with whatever you enter into this field. If you specify "https://" then it will only test for SSL-capable servers on commonly configured SSL ports, otherwise it will eventually try several well-known plain http.

If it's not successful you'll be prompted whether you want to save the settings anyway, which you may want to do so you can come back and edit them further when you know more.

If your server software has instructions about configuring access by CalDAV clients they will usually have two types of information: details for calendar based CaLDAV clients such as Mozilla Lightning or the various CalDAV and CardDAV sync clients for Android, and details for principal based CalDAV clients such as Apple's various clients. aCal follows a principal based approach, so those kind of instructions will be the best ones to use. This approach means that aCal should automatically find all of your calendars and address books.

Server Specific Configuration Details

Where we know additional details or nonstandard behaviour of a server, this is accessible via the compatibility list.

If your server isn't listed, there is some more information about the exact process aCal follows on the AutoDiscovery page which may help you work out the configuration you need so you can add a page about your server for other people to use in the future, or so you can post some useful details to the mailing list to help diagnose the issue and improve the process.

Saving a Server Setup to your SD Card

Once you have saved a server setup you can "long press" on it in the server list to get a context menu, including the option to "Export". This will create a small XML file in the "acal" folder on the phone's removable storage (usually something like /sdcard/acal/ServerName.acal). You can copy this file and edit it to remove the username/password details (and maybe tweak the path a little) and pass it on to others make it easier for them to configure their connection to that server. Or you can just keep it in that place and if you delete your aCal configuration this setting will appear in the list for you to re-add it.

Configuring Preferences and Collections

You may want to change some of aCals preferences or configure your calendar and addressbook collections.

Advanced Settings

You really should not need to go into the Advanced Settings, but they're available if you're absolutely convinced you need them. If you use these settings you are saying to aCal that you know exactly what you need to set everything to. Press the 'menu' button when you're looking at the normal server settings to see these.

If aCal has discovered your server already then these values will show exactly what it discovered.

CalDAV Server The server name for the CalDAV server
Principal Path The path to the principal resource on the CalDAV server
Use SSL whether to use SSL for this connection
Authentication type whether to use No auth, Basic Auth or Digest auth.
Port number The TCP port to use for this connection
Personal tools