You're browsing the documentation for an old version of SupportPal. Consider upgrading to the [latest version](https://docs.supportpal.com/current/System+Requirements). 

# System 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.2.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](http://www.ioncube.com/loaders.php) - **v10.2 and above**
- JSON
- Mbstring
- OpenSSL
- PDO (with MySQL Client Driver 5.6.0+ or [MySQLnd](http://php.net/manual/en/book.mysqlnd.php) 5.0.9)
- Tokenizer
- XML
 
  - IMAP - when using [email download](Email+Download) to pull in department tickets
- LDAP - when using [LDAP operator authentication](LDAP+Accounts)
- Gettext - when using [SAML Authentication](SAML+Authentication)
- Date - when using [SAML Authentication](SAML+Authentication)
- Zlib - when using [SAML Authentication](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`](http://php.net/manual/en/filesystem.configuration.php#ini.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](http://php.net/manual/en/image.installation.php) 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. On Linux we recommend setting the below directories to *755 permissions*, but in some instances *777 permissions* may be required.

- `storage/`
- `config/`
- `bootstrap/cache/`

## 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:

- `<a class="external-link" href="https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_max_allowed_packet" rel="nofollow">max_allowed_packet</a>` - 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](New+Installation).

  **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](https://httpd.apache.org/docs/2.4/mod/mod_allowmethods.html) 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