- 1. PHP Version
- 2. File Permissions
- 3. Database
- 4. Web Server
- 5. Firewall Requirements
Faveo requires a fairly standard PHP & MySQL server setup in order to be installed and function correctly. If you require any assistance with setting up Faveo or determining if your system can support Faveo, please contact us.
1. PHP Version
PHP versions 7.3.x are supported.
For assistance installing a new version of PHP please contact your hosting provider or server administrator.
a. PHP Extensions
- GD (requires libpng and libjpeg)
- ionCube Loaders v10.3 and above for PHP 7.3.x
- PDO (with MySQL Client Driver 5.6.0+ or MySQLnd 5.0.9)
- XML (with libxml2 version 2.7.0 or above)
- IMAP - When using email download to pull in department tickets
- LDAP - When using LDAP operator 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.
b. PHP Settings
Your PHP configuration must adhere to the following settings:
! allow_url_fopenEnabled To use Gravatar and other Faveo features,
allow_url_fopenmust 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
- PNG & JPG Support
If the PHP GD extension has been manually compiled, please ensure the
--with-jpeg-dirflags are provided.
- Disabled functions
If you’re running under a particularly strict environment, please ensure that the following functions are not listed under the
- Memory Limit A minimum of 128MB addressable memory is required to install and use Faveo. We recommend at least 256 MB. For assistance on modifying your PHP configuration, please contact your hosting provider or server administrator.
2. File Permissions
The following directories (and directories within recursively) must be writable by the PHP/Web Server process.
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
b. IIS (Windows)
Right click on the folder containing the Faveo 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.
MySQL Server 5.7.x supported. MariaDB 10.3 also supported.
b. User Privileges
For day to day use, the following database privileges are required.
- LOCK TABLES
For installing and upgrading the system, as well as activation and deactivation of plugins, the following additional privileges are required.
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.
4. Web Server
Faveo 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.
Depending on the web server you are running, you may need to configure it further to run SupportPal correctly - for example, ensuring all the HTTP request verbs (DELETE, GET, OPTIONS, POST and PUT) are enabled. Below is a list of common web servers and steps required for them.
Apache is supported out of the box.
On nginx, please create a new virtual host for Faveo. The below is an example virtual host but will need editing for your specific environment (paths may vary): faveo.conf
On IIS, please create a web.config file in the root of your installation directory with the below contents: web.config
Required Extension(s) The URL Rewrite extension is required for the below web.config file to function correctly, otherwise a 500.19 error is likely to be shown when visiting Faveo (see Understanding HTTP Error 500.19).
Please replace the follow constants in the below code snippet:
5. Firewall Requirements
Please open outbound access to billing.faveohelpdesk.com