Skip to content

Reporting Bugs

Chris King edited this page Jan 7, 2017 · 5 revisions

FiercePhish Wiki

Occasionally something breaks that I can't foresee. That's why you're here! Follow the instructions below to gather as much information as you can for a bug report.

Log files to include

  • Laravel.log, by default stored in /var/www/FiercePhish/storage/logs/laravel.log
  • Apache log, by default stored in /var/log/apache2/error.log

Installation log

If you are having problems with the automated installer, you can either set "VERBOSE=true" for method #1 or run ./installer.sh -v for method #2.

Once you have verbose enabled, redirect the output to a file (and give me the log file):

  • For method #1:

    curl https://github.com/Raikia/FiercePhish/blob/master/installer.sh | bash | tee log_file.txt

  • For method #2:

    ./installer.sh -v | tee log_file.txt

Screenshots and debug mode

Screenshots of the bug are hugely helpful, as are reproduction steps. You can even set "DEBUG" mode on, both via the web interface ("Settings" --> "Configurations" --> "Application Debugging"), or via the configuration file (by default located in "/var/www/FiercePhish/.env") (set "DEBUG=true").

Give as much information as possible!

Bug reports are only as useful as the amount of information provided. The more you provide, the faster I can fix the bug to get a fix out to you!

Report the bug

Once you have all the information above, go to Github Issues, click "New Issue", and put all the information together in there.