Submitting an issue

How to submit an issue

To help us diagnose and resolve problems efficiently, please follow the process below when submitting an issue.

1. Enable debug logging

Before reproducing the issue, set the log level of all relevant components to DEBUG. This ensures we capture the necessary details for troubleshooting.

2. Reproduce the problem

Reproduce the issue while DEBUG logging is enabled. The logs will automatically include:

• Application version

• Operating system information

3. Collect logs

After reproducing the issue, gather logs from all relevant components. Make sure to include all of them in your report.

4. Provide steps to reproduce

In addition to logs, clearly describe how the issue can be reproduced. Include:

• Exact steps you took

• Expected behavior

• Actual behavior

5. Submit your report

Go to Defguard issues page and open a new issue. When opening an issue, attach:

• Logs from all components

• Clear reproduction steps

• Any additional context you think may help (environment details, configuration snippets, etc.)