[baikal] error 500 when accessing calendars / how to solve

[karlquint]

Description:
I installed Baikal 0.9.5 using the current instructions in Uberspace Lab. The installation and initial setup of the database worked. However, connecting to Thunderbird or iCal did not work.

Steps to Reproduce:

• Follow the installation instructions in Uberspace Lab to install Baikal 0.9.5.
• Complete the initial setup of the database.
• Try to connect to Thunderbird or iCal using the provided URLs.

Expected Result:
Successful connection to Thunderbird or iCal.

Actual Result:
Connecting to Thunderbird or iCal did not work. During troubleshooting, I tried to access the calendar in the web browser by navigating to 'https://domain.tld/baikal/html/dav.php/calendars/user/default' and always received an HTTP 500 error.

Logs:
After reviewing the logs and the Baikal-config, I noticed the following entry in /baikal/config/baikal.yaml:
base_uri: ''

I had to set this to:
base_uri: '/baikal/html/'

After this change, the connection worked.

Additional Information:
It would be helpful to point out that the integration into Thunderbird or other calendar apps can vary. I had to search for the correct configuration online. For example, here are the settings that worked for me:

MacOS Calendar:

• Server: https://domain.tld
• Address / path: /baikal/html/dav.php/principals/user/

Thunderbird:

• URL: https://domain.tld/baikal/html/dav.php/calendars/user/default

Environment: Baikal version: 0.9.5
Installation method: Uberspace Lab

Suggested Fix:
Update the documentation to include the necessary configuration change in the baikal.yaml file and provide examples for integrating with different calendar applications.