Alberto Bertogli
9a59bd77d1
This patch uses mdformat to auto-format markdown documentation. To support \ for line breaks (which is what mdformat uses), mkdocs now requires the pymdownx.escapeall extension. Because of incompatibilities between mdformat (which formats to CommonMark) and mkdocs (which expects Python-Markdown), there are now some limitations: no nested lists, multi-paragraph list items, or admonitions support. These limitations are acceptable for now, although some of the docs had to be adjusted to meet them.
1.5 KiB
Known issues
This file contains a list of the most common known issues, and the release range affected. It can be useful for people running older versions, to identify problems (and workarounds) faster.
Entries are eventually be purged once their affected versions become uncommon, to prevent confusion.
Dovecot auth occasionally not functional after a reboot (0.04 to 1.6)
After a reboot, if chasquid starts before dovecot, it's possible that chasquid fails to autodetect the dovecot addresses, and the dovecot authentication will not be functional until chasquid is restarted.
This condition can be identified by seeing
Dovecot autodetection failed, no dovecot fallback in the chasquid logs, at
start-up time.
As a workaround, you can create the following systemd dropin file at
/etc/systemd/system/chasquid.service.d/after-dovecot.conf, to make chasquid
be started after dovecot:
[Unit]
After=dovecot.service
The issue is fixed in 1.7.
dkimsign causes parsing errors in post-data hook (0.07 to 1.5)
The default post-data hook in versions 0.07 to 1.5 has a bug where if the
dkimsign command exists, unwanted output will be emitted and cause the
post-data hook invocation to fail.
The problem can be identified by the following error in the logs:
Hook.Post-DATA 1.2.3.4:5678: error: error parsing post-data output: \"/usr/bin/dkimsign\\n...
As a workaround, you can edit the hook and make the change seen here.
The issue is fixed in 1.6.