# Reporting Bugs

Bug reports can be sent to us through our mailing list or logged in our GitHub issue tracker. (Registration is required) When reporting a bug, please provide the following information;

- Your platform, and if applicable, your distribution and the distribution version.

- The exact version of Cyrus IMAP or SASL you are using.

- If a packaged version is used, the source of the packaged version.

- If a custom version is used, any options that may have specified during the build process.

- If relevant, are you using altnamespace, unixhierarchysep, or virtdomains?

- If relevant, are you in a murder configuration? (In which case please provide information for all hosts)

- What did you do?

- What did you expect to happen, and what actually happened?

- If Cyrus crashed, please provide a backtrace of the core dump.

If you know how to fix the bug, we also are delighted to receive pull requests or patch snippets sent via email on the mailing lists.

Note

Cyrus IMAP Version

The Cyrus IMAP team would appreciate if you try your best to supply us with the exact version of Cyrus IMAP that you run. The Cyrus IMAP version from upstream, usually in the format x.y.z does not include important information on the build or release, nor the source for the package you may have used.

Most Linux distributions allow you do get the full version with `rpm -qv cyrus-imapd` or `dpkg -l cyrus-imapd`. If package management, for whatever reason, cannot tell you what version of Cyrus IMAP you have, connecting to your Cyrus IMAP server (typically via telnet to port 110 or 143) could.

Note

Cyrus SASL Version

The Cyrus team would appreciate if you try your best to supply us with the exact version of Cyrus SASL that you run. The Cyrus SASL version from upstream, usually in the format x.y.z does not include important information on the build or release, nor the source for the package you may have used.

Most Linux distributions allow you do get the full version with `rpm -qv cyrus-sasl` or `dpkg -l cyrus-sasl`. If package management, for whatever reason, cannot tell you what version of Cyrus SASL you have, what could?

If you run a development version of Cyrus IMAP or SASL (i.e. your own compile from GIT's master or any of the stable branches), please remember to note that in the report.