SPP Server: Installation Guide

Self-hosted SPP runs on your own server using PHP and MySQL. It comes with an installation wizard which makes setup easier.

Warning! Hosting SPP yourself requires basic system administration skills. If that’s something you’re not comfortable with, please consider SPP Cloud.

Requirements

  • Apache or Nginx webserver
  • MySQL version 5.0 or greater
  • PHP version 5.3 or greater
  • Curl, MySQLi and JSON PHP extensions
  • Ioncube Loader (most webhosts have this)

Ask your hosting provider if you are unsure whether your hosting meets these requirements. They should be able to help you enable any missing extensions free of charge.

Before Installation

  1. Create a new directory or subdomain where SPP will be installed.
  2. Upload and unzip spp-1.x.x.zip in this directory or subdomain.
  3. Change permissions for application/config/database.php to 777 (only during installation).
  4. Change owner of uploads/ and uploads/tmp/ to your www user (typically www-data) OR change permissions to 777 (not recommended).
  5. Create a new database that will be used for SPP. If you’re also creating a new user for this database, make sure the user has adequate permissions in place.

Installation

For the installation you’ll need your license code and database information, so have it ready before installing.

  1. In your web browser navigate to http://yoursite.com/spp/install (replace with your actual installation directory).
  2. The installer checks server requirements and permissions, and will let you know if there is a problem.
  3. If there are no warnings enter your database information and click “Install”.
  4. You’ll be asked to create a new Admin account. Enter your email address, choose a strong a password and paste your license code.
  5. Reset permissions for application/config/database.php back to 644.

Setting up Cron

Some tasks need to be run on a certain schedule. To enable those tasks, you will need to go into your hosting account and set up a con job that runs once a day.

The command to run is:

GET http://yoursite.com/spp/cron

(replace the link with your actual SPP installation url)

Setup a cron job

You’ll see a warning in the SPP dashboard if there’s a problem with scheduled tasks. If that’s the case, you’ll need to ask your hosting provider to provide an alternative cron command that works on their server.

Configure Email

By default SPP sends all email notifications from the server it’s installed on. In most cases that leads to emails being filtered and landing in junk folder until marked as safe.

To improve deliverability SPP lets you use a custom SMTP server like Amazon SES or Mailgun.

You can save the SMTP server, username, password and port in Settings > Email.

Updates

The system will notify you as soon as there’s a new version available.

Click on the notification and you’ll be asked for your FTP details, which the app needs to configure and restore file permissions during the update. The rest of the update process should happen automatically.

Updating manually:

First backup your database and files, particularly your database configuration located in application/config/database.php.

Download the latest version of SPP and upload it to your server replacing everything except the uploads/ directory. After that you can restore your copy of database.php.

 

Related Articles