Clone wiki

Simple Server Media Player / How to install

For italian users/per gli utenti italiani: Come installare.

Note: there are self-installing .deb package for Debian and Ubuntu users. In this case, please refer to the guide how to install on Debian or Ubuntu.


In order to install SSMP, you need just:

  • Apache 2, preferably with the rewrite and expires modules;
  • PHP 5.2.8 or greater, with the ImageMagick libraries (php5-imagick) to generate photo thumbnails;
  • ffmpegthumbnailer, to generate video thumbnails.

You didn't need a database instead.

Download and extract

We do not recommend you to install SSMP using or cloning our Git repository, as the source of Git repository do not contain the CakePHP framework and the MeTools plugin, which are required to run SSMP. In addition, sources in the Git repository contain stuff that may not be useful, such as documentation.

You can download SSMP as .tar.gz archive from the download page.
When you have downloaded SSMP, extract the archive in your Apache document root (which by default is /var/www).

For example:

tar -pzxvf ssmp*.tar.gz -C /var/www


tar -pzxvf ssmp*.tar.gz
mv ssmp* /var/www

Check that everything went well:

ls -l /var/www/ | grep ssmp
drwxr-xr-x  8 mirko mirko 4096 mar 15 13:49 ssmp-1.0.1-beta

You can also change the name of the SSMP directory, removing the version number, so the SSMP url won't be too difficult. For example:

mv /var/www/ssmp-1.2.0/ /var/www/ssmp

If you already have the CakePHP core or if you plan to use a single core for multiple applications, look here.


SSMP uses the tmp/ directory for the temporary files, then make sure that this (and all its contents) is writeable and the whole application is owned by the Apache user:

sudo chown -R www-data:www-data /var/www/ssmp
sudo chmod -R 777 /var/www/ssmp/tmp

If you don't know the user and the group used by Apache, you can find them like this:

cat /etc/apache2/envvars | grep 'RUN_USER\|RUN_GROUP'


SSMP requires PHP 5.2.8 or greater, but we strongly recommend at least PHP 5.3, if is possible.

In order to use SSMP, you must install the ImageMagick library, ie the package php5-imagick.

SSMP also needs Fileinfo and the Exif extension. In most GNU/Linux distros, these libraries are already present with the main package of PHP. In some distros (for example openSUSE), you may need to install php5-fileinfo and php5-exif packages, if these exist.


SSMP works best with these modules enabled:

  • the rewrite module, which provides the URL rewriting;
  • the expires module, which allows browsers to use the cache as much as possible.

If you don't want or can't use the rewrite module, look here.

First of all, you must be sure that .htaccess override is allowed in /etc/apache2/sites-available/default, where "AllowOverride" must be set to "All" for your Apache document root. You should have something similar to:

DocumentRoot /var/www
<Directory />
    Options FollowSymLinks
    AllowOverride All
<Directory /var/www/>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    allow from all

The content reported here is partial and your /etc/apache2/sites-available/default may be different. However, the important thing is that it's always like this:

AllowOverride All

Then, enable rewrite and expires modules:

sudo a2enmod rewrite expires

Finally, restart the Apache server:

sudo /etc/init.d/apache2 restart

or, in some distros:

sudo service apache2 restart

Using a virtual host

To get the best performance, you can use SSMP with a virtual host.
To know how to properly configure a virtual host, refer to the Apache documentation and configuration examples.

In any case, should be sufficient to create the file /etc/apache2/sites-available/ssmp, like this:

<VirtualHost *:80>

    DocumentRoot /var/www/ssmp

Or, if you're running SSMP on localhost:

<VirtualHost *:80>
    DocumentRoot /var/www/ssmp
    ServerName ssmp.localhost
    ServerAlias ssmp.localhost

Finally, enable the virtual host and restart Apache:

sudo a2ensite ssmp
sudo /etc/init.d/apache2 restart

If you're running SSMP on localhost, don't forget to edit the file /etc/hosts so you can resolve the virtual host address. For example:       localhost ssmp.localhost

Configure SSMP

When you have finished installing SSMP, you can configure it.

Further information

When you have finished installing and configuring SSMP, for every problem or for any other information, refer to the support page.

For additional information about CakePHP, please consult the CakePHP documentation: