View source for HOWTO Seek Help

There are 3 channels to find help/support for Fail2Ban.  Depending on the level/urgency you might like to use:

* IRC: #fail2ban channel on Freenode network
* Mailing list: https://lists.sourceforge.net/lists/listinfo/fail2ban-users
* Issues tracker: https://github.com/fail2ban/fail2ban/issues

Recommended steps to troubleshoot problems 

# If you are troubleshooting if a failregex is correct
#: '''check it with fail2ban-regex''' against the logfile in question and '''share its output if you end up reporting'''
# '''Verify''' that issue you are experiencing is not already reported on the [https://github.com/fail2ban/fail2ban/issues issue tracker]
#: '''If known:'''
#:: on the corresponding issue page you might find existing workarounds, or a pull-request to try, or to submit a new comment or even a pull request to fix the problem
# '''Collect information''' needed to be shared for effective troubleshooting
## ''Fail2Ban version''
##: '''If your fail2ban is outdated:''':
##:# try testing a new release -- the issue might have already being fixed in development
##:# if you can't test for some reason -- read the [https://github.com/fail2ban/fail2ban/blob/master/ChangeLog ChangeLog] if no similar issues have been fixed in recent releases
## ''Tests'': run fail2ban-testcases and paste output (with failures) - may be it would already hint you how your system is special
## ''Your OS'' (with its release version) and either you are using stock fail2ban or the one provided by the distribution through a package manager
## ''Your configuration'' (/etc/fail2ban), in particular any customizations you have done
## ''Relevant parts of /var/log/fail2ban.log file'', preferably obtained while running fail2ban with '''loglevel = 4'''
##: (set it in [Definition] section of /etc/fail2ban/fail2ban.conf or /etc/fail2ban/fail2ban.local).
##:  Send lengthy output (or with long lines) '''as an attachment''' (see next one)
## ''Relevant lines'' from monitored log files in question -- '''as an attachment''', to avoid line-wrapping which complicates testing
# '''If you encountered a new bug:'''
#: '''submit''' a new issue to [https://github.com/fail2ban/fail2ban/issues Issue tracker] and '''provide collected above information'''
# '''If you just need help with your setup:'''
#: '''report''' to IRC or the [https://lists.sourceforge.net/lists/listinfo/fail2ban-users mailing list], once again '''with above requested information'''

'''Without providing adequate details it is likely for you to not get any help''', since noone has a mind reading machine, although some Fail2ban authors [http://www.pymvpa.org/ are working on it ;-)]