Sometimes, even with all the hard work done to prepare your setup, issues occur. Generally it’s always good to check your logs (or the ones found in the module your trying to setup), but sometimes more help is needed.
General issue workflow¶
In case your issue was introduced after a (minor) upgrade, you can use opnsense-revert to downgrade specific packages installed on the system.
Using the firmware section () you can perform a health check on the system, in the right top corner of the page is a button named Audit now which can be collapsed into Health. When clicked this outputs something like the following:
***GOT REQUEST TO AUDIT HEALTH*** >>> Check installed kernel version Version 19.7.3 is correct. >>> Check for missing or altered kernel files No problems detected. >>> Check installed base version Version 19.7.3 is correct. >>> Check for missing or altered base files No problems detected. >>> Check for and install missing package dependencies Checking all packages: .......... done >>> Check for missing or altered package files Checking all packages: .... opnsense-19.7.4_1: checksum mismatch for /usr/local/etc/inc/auth.inc Checking all packages... Checking all packages......... done ***DONE***
When mismatches are reported, you can reinstall affected packages in the Packages section of the firmware screen.
In the case above you would reinstall opnsense, since the
auth.inc looks tainted.
We advise to include the output of the health check if it seems to report issues when creating bug reports on GitHub.
Always try to be precise in issue reports, either if their about a possible bug or a feature request, it helps if intentions are absolutely clear. Our GitHub repositories use templates which should guide you through, we kindly ask you to use them (tickets not using our templates are treated as low priority).