Before you report a bug

The logback community consists of those who use logback and its modules, help answer questions on discussions lists, contribute documentation and patches, and those who develop and maintain its code. Those who assist on a day-to-day basis resolving bug reports do this for a wide variety of reasons, and almost all of them do this on their own time.

Many bugs reported end up not being a bug in logback, but are due to misconfiguration, problems caused by installed applications, the operating system, etc.

Before reporting a bug please make every effort to resolve the problem yourself. Just reporting a bug will not fix it. A good bug report includes a detailed description of the problem and a succinct test case which can reproduce the problem.

Review the documentation

Review the documentation for the version of component you are using. The problem you are having may already be addressed in the documentation.

Search the mailing list archives

It is very likely you are not the first to run into a problem. Others may have already found a solution. Our various mailing lists are likely to have discussed this problem before.

Search JIRA or Github Issues

Please search the bug database to see if the bug you are seeing has already been reported. The bug may have already been fixed and is available in a later version. If someone else has reported the same bug, you could add supporting information to help reproduce and resolve the bug.

Searching on Jira (legacy)

As the Jira software is being deprecated by Atlassian, we are migrating Github. However, the Jira server still contains a large number of issues which you can browse, edit or comment upon. Please note that all new issues must be created on Github.

Searching on Github

Reporting a bug

Only after you have exhausted the aforementioned steps, should you file a formal report in Github.

Please make sure you provide as much information as possible. It is hard to fix a bug if the person looking into the problem cannot reproduce it.