Reporting bugs

In case you are unsure if what you found is a bug, or if you have other issues that are not bugs, please use the forum, IRC or mailing list.

Report bugs pertaining OpenWrt functionality and device support using our issue trackers:

If you are unsure, please use the Packages tables to know where you should report the bug.

When reporting bugs, please be sure to specify:

  • Name the tree/revision/version
  • Name the affected device
  • What does it do that it should not do / what does it not do that it should do
  • Steps to reproduce
  • What you have already done to workaround/fix the problem
  • Any additional info you think is important

Remember, the better is your bug report, the more likely it is that it will be worked on, How to Report Bugs Effectively is recommended reading.

:!: Reporting a bug is important as it raises awareness of an issue, but it does not constitute a claim that anyone has to work on fixing it.

If you found a (potential) security problem and would like to report this confidential to the OpenWrt project please use contact@openwrt.org.

Non-security related bug reports and support requests send to this email address will be ignored. Mails send to this address are received by most of the developers with commit access. We haven't set up a PGP key to send encrypted mail for this mail address yet.

Please also inform us about CVEs you opened against OpenWrt using that e-mail address, preferably before the details are published, but please do so at latest at the time of publishing.

In the context of an ui issue, clear steps to reproduce would be:

  • Describing the initial state (starting of a fresh config, sysupgraded from older version with retaining settings)
  • Briefly mentioning the steps taken in which order, e.g.:
  1. What page browsed to
  2. What buttons pressed
  3. Any settings/options checked/typed/selected
  4. What button selected to save/apply
  5. Clearly note error
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
  • Last modified: 2022/06/16 13:53
  • by lleachii