Reporting Bugs

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/firephish/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/FirePhish/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/firephish/.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.