101: Installing spt

It’s so easy, you should pay us!

Installing the spt is simple, kind of like using the spt.  Wait, I think there’s starting to be a trend here…

OK, anyhow, back to installing spt.  Here’s a quick start guide for you to use.

Applies to

  • Version 0.6
  • Last updated on March 17, 2012

The Basics

  1. Ensure you have a server environment with Apache, PHP and MySQL.  See the requirements page for more information.  WAMP works great if you want to run the spt on a Windows host.
  2. Create and configure the MySQL database.  spt will need a MySQL database to house its data, so go ahead and create that database and configure the associated user account for the new database with ALL PRIVILEGES assigned to it.  Need help?  Check out this YouTube video.  Be sure you record the database name, user name and password in a safe place–you’ll need it soon to install spt!
  3. Extract the spt files from the archive.
  4. Create a new directory on your web server, such as “spt” and upload the files to the directory.
If you are installing spt onto a clean Linux environment, then you may need to ensure the account PHP is running under has RWX permissions on the directory you uploaded the files to.  Use the following commands, modifying as needed to match your environment:  chgrp -R <group> <folder> & chmod -R 775 <folder>.  For Ubuntu, you would use www-data for the group, for RedHat / CentOS, you would use apache for the group.  Other distributions may use other groups.  The folder is where you extracted spt to.  If you don’t modify the permissions, you probably will not be able to get past step 5 in the installation phase below.

Install spt

Check out  the 30 second video below that shows you how quick, and simple, it is to install the spt.

There is no sound in this video, you are not going crazy!

  1. Open your web browser and navigate to the location where you uploaded the files and browse to install.php.  For example, http://www.myhost.com/spt/install.php.  If you accidentally just go to the root of the folder you placed the files in, you’ll see the page below.  Start the installation by clicking the Go to Install box if needed.

  1. When prompted to accept the GNU General Public License, click the “I Agree!” button.  For reference, you can read the full text of the license in the license.htm file included in the root of the extracted files.
  2. On the next page, seen in the images below, you will get feedback on the readiness of your server to install the spt.  You can learn more about any failed items by hovering over the icon.  Click the “Proceed!” button if all checks passed, or click the “Proceed Anyways” button if one of the checks failed and you have verified that the spt installer is reporting incorrectly.
The permissions check will not report correctly on WAMP.  You should be able to proceed with no issues on a WAMP installation as long as you have not changed any permissions from their defaults in the WAMP directory.
  1. On the next page, seen in the image below, you’ll need to provide those database details from earlier.  The default server and database ports are provided, be sure to change them if your installation will require something else.  Enter in the remaining required information and click the “Install Database!” button to get things moving along.

Be sure to use the actual server IP address or fully qualified host name on step 3 that you intend to use to log into the spt once it has been installed.  The server IP address or fully qualified host name that you enter in your browser address bar to log into the spt will, by default, determine the composition of your campaign phishing email links.  See article 099: Troubleshooting the spt for more information on this and how to change it later.
  1. If all goes well, you’ll see the page below.  Click “Continue!” to move on.
  1. If instead you see an error indicated, click the “<back” button to go back and enter the database information again.
  2. Now it’s time to create your first user, for you!  As seen in the image below, enter your first and last name, email address and password and click the “Create User” button to continue on.

  1. If you receive any errors, such as for an invalid email address or a password that does not match, click the “<back” button and try it again.
  2. Once you enter the required information successfully, you  will receive confirmation as shown below.  Click the “Proceed to Login” button to get logged into the spt!

  1. Now it’s time to login using the email address and password you entered in the previous step.  See, that was easy!