Skip to content

Troubleshooting

Chris King edited this page Jan 4, 2017 · 19 revisions

FirePhish Wiki

This page contains troubleshooting information for all parts of FirePhish. This should be your first stop if you are having issues. All known bugs will be put in this wiki page and solutions for them (if they exist).

General

I updated the ".env" file but my changes don't seem to have worked

If you make changes to ".env", make sure you run php artisan config:cache afterwards. This will solve a lot of problems you may have related to configurations.

Features

URL Prefix

I forgot what my prefix was!

If you forgot what the prefix that you set was, you will have to manually look at the configuration file on the server. Find the ".env" file (by default at "/var/www/firephish/.env") and look at the "URI_PREFIX" variable.

For example, if the .env file says: URI_PREFIX=this/is/it, browse to FirePhish by going to http://domain.com/this/is/it/.

I updated the prefix in the web interface, but the page refreshed and it I got a 404 error

Sometimes this happens if the config files don't re-cache fast enough or if your APP_URL variable is not properly set. First, try to manually browse to what you set the prefix to. For example, if you set the prefix to: this/is/it, browse to http://domain.com/this/is/it/.

If that doesn't work, investigate the .env file (by default at "/var/www/firephish/.env"). Look at "URI_PREFIX" variable and use that as the prefix in your web browser. Lastly, change "URI_PREFIX" to "null" (URI_PREFIX=null) to get rid of the prefix and try again (if you update the ".env" file, make sure you then read this).

To prevent this from happening in the future, make sure "APP_URL" (or "Application URL" under "Settings"-->"Configuration") is set properly (either the publicly facing IP address or the domain name).

(This should be fixed as of Issue #11 being resolved. If it still persists, open a new Issue)

User Management

I forgot my username and/or password. What can I do?

The easiest way to recover your instance if you forgot your username and/or password is just by making a new account. You can do this via commandline:

php artisan fp:createuser

After you create a new account, either modify your old one with a new password or delete it (or ignore it).