01 ‐ Reporting Issues

Before reporting a new issue, please:

Item related issue

• Validate item with
  • ICS: https://icalendar.org/validator.html
  • VCF: no online validator known so far, but see for offline validators
    • https://github.com/EBIvariation/vcf-validator
    • https://gitlab.com/engmark/vcard/
  • If unsucessful, check what kind of software has generated the item and check for update/issues here
  • If successful, since 3.6.0 a particular item can be verified with (Check whether it can be reproduced with latest version of server software)

radicale --verify-item /path/to/item.txt

• Check for any open/closed issues/discussions in
  • https://github.com/Kozea/Radicale/issues
  • https://github.com/Kozea/Radicale/discussions

Server related issue

• Check whether it can be reproduced with latest version of server software
• Check for any open/closed items in
  • https://github.com/Kozea/Radicale/issues
  • https://github.com/Kozea/Radicale/discussions
• Distinguish between
  • Server software issue (e.g. exception)
  • Server configuration issue
  • Server filesystem permission issue

Client related issue

• Check whether it can be reproduced with latest version of client software
• Check for any open/closed items in
  • https://github.com/Kozea/Radicale/issues
  • https://github.com/Kozea/Radicale/discussions
• Open ticket towards client, if interesting for others, reference it in a new ticket in https://github.com/Kozea/Radicale/discussions