Installing Baïkal (CalDAV and CardDAV server)

You need to follow these steps to install Baïkal:1. We recommend that you create a separate subdomain for the Baïkal installation. You can do that in the Subdomains section of the hosting Control panel.2. Download the installation from the releases page on GitHub:https://github.com/sabre-io/Baikal/releases3. Once you have downloaded the archive that contains the installation, you need to upload it into your hosting disk space and extract it. Please make sure that you upload it to the subdomain you created in step 1. After extracting the archive, you need to move all files from the baikal directory to the main subdomain directory. In addition, you have to change the permissions of all folders of the installation to 775 (recursively).You can use the File Manager in the hosting Control Panel for the above actions. 4. Create a new MySQL database and user for the Baikal application. For security reasons, MySQL databases and users can be created only through the hosting Control Panel.  Once you have the database and MySQL user created, you should make sure that the user is associated with the database. You can do that through the MySQL Databases section of the hosting Control Panel. 5. Visit the Baïkal installation location in a new browser window. Go to the html folder. 6. You need to specify the following settings: Server Time zone: Choose the appropriate time zone (America/New_York for example).Enable CalDAV: Check this option if you wish to enable the CalDAV functionality of Baïkal.Enable CardDAV: Check this option if you wish to enable the CardDAV functionality of Baïkal.WebDAV authentication type: Choose Digest.Admin password: Enter a password for the Baïkal administrative interface.Admin password, confirmation: Re-enter the password. Press the Save changes button.7. On the next step, select the Use MySQL checkbox. Configure the following database settings: MySQL host: localhost (for MySQL 5) or 127.0.0.1:3308 (for MySQL 8)MySQL database name: You need to enter the name of the MySQL database you created for your Baikal application.MySQL username: You need to enter the MySQL username you created at your web hosting Control Panel's MySQL section for your Baïkal application.MySQL password: You need to enter the password you assigned to your MySQL user. Click on the Save changes button.8. You are done. Baïkal is installed successfully. Click the Start using Baïkal button to open the Baïkal administrative interface.IMPORTANT SECURITY NOTICE: You should monitor the site of the software vendor for any security updates of your installed application.

You need to follow these steps to configure the Thunderbird Lightning add-on for accessing a Baïkal CalDAV installed on your account. The Thunderbird Lightning add-on can be obtained at https://addons.mozilla.org/thunderbird/addon/lightning/ Please replace: username with your Baïkal username baikal.example.com with the subdomain where you installed Baïkal   1. Open Thunderbird. 2. Choose "File" -> "New" -> "Calendar". 3. Choose "On the Network". Click on the "Next" button. 4. Choose the "CalDAV" option. 5. In the "Location" field, you need to enter "http://baikal.example.com/html/cal.php/calendars/username/default/" where "baikal.example.com" is the subdomain where you installed Baïkal, "username" is the Baïkal username for the calendar, and "default" is the name of your calendar. Note: In Baïkal 0.8.0+, you can view the configuration settings by clicking on the "i" button next to each calendar within the Baïkal CalDAV dashboard. Click on the "Next" button. 6. In the "Name" field, you need to enter the desired calendar name. You can choose whatever you want. Click on the "Next" button. 7. Click on the "Finish" button on the next screen. 8. Thunderbird will ask you for your Baïkal username and password. Enter them, check the "Use Password Manager to remember this password" option, and click on the "OK" button.

You need to follow these steps to configure the Thunderbird Sogo Connector add-on for accessing a Baïkal CardDAV installed on your account. The Thunderbird Sogo Connector add-on can be obtained at http://www.sogo.nu/english/downloads/frontends.html Please replace: username with your Baïkal username baikal.example.com with the subdomain where you installed Baïkal   1. Open Thunderbird. 2. Choose "Tools" -> "Address Book". 3. In the Address Book, choose "File" -> "New" -> "Remote Address Book". 4. In the "Name" field, you need to enter the desired address book name. You can choose whatever you want. In the "URL" field, you need to enter "http://baikal.example.com/html/card.php/addressbooks/username/default/" where "baikal.example.com" is the subdomain where you installed Baïkal, "username" is the Baïkal username and "default" is the name of your address book. Note: In Baïkal 0.8.0+, you can view the configuration settings by clicking on the "i" button next to each address book within the Baïkal CalDAV dashboard. Click on the "OK" button. 5. Right-click the newly created address book (Your Address Book in the example) and choose "Synchronize" from the context menu. 6. Thunderbird will ask you for your Baïkal username and password. Enter them and click on the "OK" button.

You need to follow these steps to configure Calendar for Mac for accessing a Baïkal CalDAV installed on your account. Please replace: username with your Baïkal username baikal.example.com with the subdomain where you installed Baïkal   1. Open Calendar. 2. Choose "Calendar" -> "Add Account..." 3. Choose "Add CalDAV Account..." and click on the "Continue" button. 4. Choose "Advanced" for "Account Type". In the "Username" and "Password" fields, you need to enter your Baïkal username and password. In the "Server Address" field, you need to enter "http://baikal.example.com" where "baikal.example.com" is the subdomain where you installed Baïkal. In the "Server Path" field, you need to enter "/html/cal.php/principals/username" where "username" is the Baïkal username for the calendar. Note: In Baïkal 0.8.0+, you can view the configuration settings by clicking on the "i" button next to each calendar within the Baïkal CalDAV dashboard. Click on the "Create" button. 5. Calendar will ask you for your Baïkal password. Enter it and click on the "OK" button.

You need to follow these steps to configure Contacts for Mac for accessing a Baïkal CardDAV installed on your account. Please replace: username with your Baïkal username baikal.example.com with the subdomain where you installed Baïkal   1. Open Contacts. 2. Choose "Contacts" -> "Add Account..." 3. Choose "Other contacts account..." and click on the "Continue" button. 4. In the "Username" and "Password" fields, you need to enter your Baïkal username and password. In the "Server Address" field, you need to enter "http://baikal.example.com/html/card.php/addressbooks/username/default" where "baikal.example.com" is the subdomain where you installed Baïkal, "username" is the Baïkal username for the calendar, and "default" is the name of your address book. Note: In Baïkal 0.8.0+, you can view the configuration settings by clicking on the "i" button next to each address book within the Baïkal CalDAV dashboard. Click on the "Create" button.