Automated Installation Guide
This is the preferred method of installing FiercePhish + SMTP + IMAP services.
The installation script can be run multiple times with no issue. It will reconfigure all settings to be the latest
- Ubuntu 16.04
- Ubuntu 16.10
(Fresh installs are expected, but the installer should work on a used OS with no problems)
If you would like a different OS distribution supported, create a Github issue
- Purchase a domain name to send emails from
This isn't required, but it is heavily suggested. Phishing campaigns where you spoof an active domain you don't own are extremely susceptible to being spam filtered (unless the domain's SPF record is improperly configured). The best way to perform a phishing campaign is by buying a generic domain that can fool someone ("yourfilehost.com") or a domain that is very similar to a real domain ("microsoft-secure.com").
This method is probably the easiest way to install/configure everything. It is a fully unattended installation (aside from the beginning).
- You must run the installer as root:
sudo su
- Generate the configuration file:
curl https://raw.githubusercontent.com/Raikia/FiercePhish/master/install.sh | bash
- This will create a configuration file located at "~/FiercePhish.config". You must edit this file before moving on!
Click here for a detailed description of the configuration variables
- Once "CONFIGURED=true" is set in the configuration file, re-run the install script:
curl https://raw.githubusercontent.com/Raikia/FiercePhish/master/install.sh | bash
-
Sit and wait. The installation could take anywhere from 5-15 minutes depending on your server's download speed.
-
Once the installation completes, follow the instructions it prints out. It will tell you what DNS entries to set.
This method is just as easy as method #1, but the install will prompt you as it runs for the information it requires (as opposed to using a configuration file like method #1).
- You must run the installer as root:
sudo su
- Download the configuration file:
wget https://raw.githubusercontent.com/Raikia/FiercePhish/master/install.sh
- Set the installer as executable:
chmod +x install.sh
- Run the installer:
./install.sh
The installer will prompt you for the same information as is described in the configuration file for method #1. See that wiki page for information on what to provide.
-
Sit and wait. The installation could take anywhere from 5-15 minutes depending on your server's download speed. It will prompt you periodically, so make sure you pay attention. If you want to hit install and go afk, use method #1
-
Once the installation completes, follow the instructions it prints out. It will tell you what DNS entries to set.
If you have errors with the installation script, you can safely rerun the script without messing anything up (even if you provide it different information). If you continue to have problems, set "VERBOSE=true" (for method #1) or run ./install.sh -v (for method #2) to see the full log of everything running. If you still have problems, submit a bug report.