You're browsing the documentation for an old version of SupportPal. Consider upgrading to the latest version.

System Requirements

Contents

PHP Version
PHP Extensions
PHP Settings
File Permissions
Database
Web Server
Firewall Requirements

SupportPal requires a fairly standard PHP & MySQL server setup in order to be installed and function correctly. If you require any assistance with setting up SupportPal or determining if your system can support SupportPal, please contact us.

PHP Version

PHP versions 7.0.8 - 7.3.x are supported.

For assistance installing a new version of PHP please contact your hosting provider or server administrator.

PHP Extensions

Required	Optional
BCMath cURL DOM FileInfo GD (requires libpng and libjpeg) Iconv ionCube Loaders v10.2 and above for PHP 7.0.8 - 7.2.x v10.3 and above for PHP 7.3.x JSON Mbstring OpenSSL PDO (with MySQL Client Driver 5.6.0+ or MySQLnd 5.0.9) Tokenizer XML	IMAP - when using email download to pull in department tickets LDAP - when using LDAP operator authentication Gettext - when using SAML Authentication Date - when using SAML Authentication Zlib - when using SAML Authentication

PHP extensions differ depending on your server, your host and other system variable. For assistance installing missing extensions, please contact your hosting provider or server administrator.

PHP Settings

Your PHP configuration must adhere to the following settings:

allow_url_fopen Enabled
To use Gravatar and other SupportPal features, allow_url_fopen must be enabled in your PHP configuration.
IPv6 Support
If your server has IPv6 networking support, this should be enabled by default. However if not please ensure you have the php-sockets extension enabled and PHP has been compiled with the --enable-ipv6 flag.
PNG & JPG Support
If the PHP GD extension has been manually compiled, please ensure the --with-png-dir and --with-jpeg-dir flags are provided.
Disabled functions
If you're running under a particularly strict environment, please ensure that the following functions are not listed under the disable_functions directive: ini_set
Memory Limit
A minimum of 128MB addressable memory is required to install and use SupportPal. We recommend at least 256 MB.

For assistance on modifying your PHP configuration, please contact your hosting provider or server administrator.

File Permissions

The following directories (and directories within recursively) must be writable by the PHP/Web Server process.

storage/
config/
bootstrap/cache/

Linux

We recommend setting the above directories to 755 permissions. You may also need to adjust the owner and group of the directories.

chmod -R 755 /path/to/directory
chown -R www-data:www-data /path/to/directory

If you're using CentOS, it has SELinux enabled by default which has measures in place to prevent httpd from writing to files, beyond the normal file permissions. You need to apply httpd_sys_rw_content_t to the directories:

chcon -Rv --type=httpd_sys_rw_content_t /path/to/directory

IIS (Windows)

Right click on the folder containing the SupportPal files, click Properties and then the Security tab. Click Edit... and then Add..., enter IUSRS and click Check Names. Click OK, and check the Full Control checkbox in the permissions. Do the same for the IIS_IUSRS group too.

Database

Version

MySQL Server 5.6.0 - 5.7.x, 8.0.x supported. MariaDB 10.0 - 10.3 also supported.

Settings

We recommend the following MySQL configuration directives are changed:

max_allowed_packet - we recommend greater than 20MB to ensure large emails and embedded images are correctly handled.

For assistance on modifying your MySQL configuration, please contact your hosting provider or server administrator.

Web Server

SupportPal supports Apache, nginx and IIS web server, in all cases you must enable the mod_rewrite module for SEO friendly URLs.

Apache works out of the box, however for nginx and IIS you will need to install the rewrite rules.

HTTP Request Verbs
Please ensure your web server is configured to allow HTTP GET, POST, PUT and DELETE requests. If using Apache and have mod_allowmethods enabled you may need to update your web server configuration to permit all four verbs.

Firewall Requirements

Outbound port 443 access to licensing.supportpal.com