doc/app_baikal.md

Baïkal

Index

• Configuration
  • Login to admin interface
  • Creating a new user
• CalDAV connection
  • Connecting Thunderbird with Lightning
  • Connecting to AgenDAV
• CardDAV Connection
• Useful links

Baïkal is a server for calendars and address books, which uses the CalDav and CardDav protocol. Baïkal can be synced with a lot of clients, like Thunderbird + Lightning.

WARNING: Baikal will not work if you have installed a Nextcloud ( their cardav/caldav functions conflict).

Configuration

Connecting to the administration interface

To configure the app, go to the address: sub.domain.tld/admin or domain.tld/baikal/admin. The username to specify is admin, followed by the specific password you chose when installing Baïkal. The password can contain any special characters.

LDAP authentication

By default, Baikal is configured to lookup users in YunoHost's LDAP directory. YunoHost's users will appear under User and ressources menu after their first successful authentication.

Creating a new user

Go to the settings tab, select Digest from WebDAV authentication type. Add users in the Users and resources tab.

CalDAV connection

Connecting Thunderbird with Lightning

Add a new agenda with type "Network" and "CalDAV"

The new URL to add is :

https://domain.org/baikal/cal.php/calendars/username/default

Be careful to replace "domain.org" by your own domain and the "username" by your user name.

Connecting to AgenDAV

AgenDAV is a web client for using your calendars. It's packaged for Yunohost and you can used it after installing Baïkal.

AgenDAV is already connected to Baïkal, any other configuration is necessary. If you create a new entry in Thunderbird + Lightning calendar, refresh your AgenDAV page is enough to see your modifications.

AgenDAV also allows you to create a new calendars very easily.

CardDAV Connection

Using the example with RoundCube Add a new address book by going to Settings > Preferences > CardDAV.

Make sure it is filled with:

• Addressbook name: default

• Username: username

• Password: thePasswordAssociatedToUsername

• URL : https://example.com/baikal/card.php/addressbooks/username/default

• Make sure to replace "example.com" with your domain and "username" with your username*

Save.

Now, the adressbook is accessible.

Useful links

• Website: www.baikal-server.com
• Official documentation: sabre.io - baikal
• Application software repository: github.com - YunoHost-Apps/bikal
• Fix a bug or an improvement by creating a ticket (issue): github.com - YunoHost-Apps/baikal/issues