| Table of contents |
|---|
This page describes required web server configuration that you need in order to install Kayako Fusion, Kayako Resolve or Kayako Engage.
Server software requirements
PHP
PHP
5.2.8 or later is required.
| The Reports features require PHP 5.3. We will be phasing out support for PHP 5.2, but for now it is possible to get by. |
MySQL server
MySQL
version 5.0 or later (we recommend the very latest stable release)
PHP decoders
Portions of the Kayako code are encoded and require a PHP decoder in order to run. There are two available, both free.
Zend Optimizer
(Supported PHP version: 5.2.x or earlier)
OR
ionCube Loader
(Supported PHP version: 5.3.x or earlier)
Web server
Any web server daemon - such as Apache, nginx, IIS which is fully compatible with the required PHP configuration.
PHP settings
- max_execution_time
: "600" - max_input_time
: "600" - magic_quotes_gpc
: "Off" - memory_limit
: "256M" (this will vary - if you plan on using the Kayako import tool, or if the web server is shared, a higher limit is required) - file_uploads
: "On" - upload_max_filesize
: "20M" - max_file_uploads
: "20"
Apache server settings
If you have mod_security installed on your apache web server, mod_security must be disabled or your Kayako helpdesk files whitelisted (exempt from all mod_security rules).
MySQL settings
- sql_mode
: not strict
Required PHP modules
Most of these modules are included by default. However, we have compiled a list of those which are definitely required by Kayako for good measure:
- mbstring

- mcrypt

- gd
with Freetype support - curl

- mysql

- pdo

- pdo_mysql

- simplexml

- filter

- json

- imap

- sockets

- xml

PHP cache and accelerators
Kayako accesses many scripts spread across many files for each connection. We strongly recommend that your web server has a PHP opcode cache like xcache
, apc
or eaccelerator
installed. We find that xcache
is the easiest to install and most readily available.
13 Comments
comments.show.hideFeb 02, 2011
Mike
Additional php.ini settings must be set:
allow_url_fopen = On
allow_url_include = On
To prevent:
[Warning]: file_get_contents() [<a href='function.file-get-contents'>function.file-get-contents</a>]: URL file-access is disabled in the server configuration (ProfileImage/class.SWIFT_ProfileImage.php:99)
Feb 22, 2011
Mike
As of this posting, Fusion is NOT compatible with Zend Guard Loader for PHP 5.3. IonCube is generally not a good choice for performance. For those who tried PHP 5.3 and got this:
Fatal error: Incompatible file format: The encoded file has format major ID 3, whereas the Loader expects 4 in /var/www/html/__swift/swift.php on line 0
Kayako needs to encode Fusion separately for Zend Guard Loader in order for it to work. If you absolutely must have PHP 5.3, ionCube is the only option at this time.
Mar 15, 2011
Gaurav Kumar
Hi Mike,
We degraded PHP 5.3 to PHP 5.2 and then installed fusion along with ZendOptimizer. We are using the following build versions :
1. Fusion : fusion_stable_zendclosed_4_01_139
2. ZendOptimizer : ZendOptimizer-3.3.9-linux-glibc23-x86_64
Everything seems to be fine as of now. Should PHP version be an issue later. If yes, is Ioncube the only option ?
May 21, 2011
Steven Aerts
Hello,
while installing kayako fusion 4.01.204 an it returned an error as it could not find the xml_parser_create function. I had to install an extra requirement for this: xml
.
It is maybe a good idea to update the requirement list accordingly.
Best regards,
Steven
May 25, 2011
Jamie Edwards
Thank you - we've added that.
Jul 22, 2011
lexore
Additional php.ini settings must be set:
magic_quotes_runtime = Off
magic_quotes_sybase = Off
To prevent:
[Notice]: Trying to get property of non-object (Mail/class.SWIFT_Mime.php:170)
[Notice]: Trying to get property of non-object (Mail/class.SWIFT_Mime.php:171)
[Notice]: Trying to get property of non-object (Mail/class.SWIFT_Mime.php:177)
[Notice]: Trying to get property of non-object (Mail/class.SWIFT_Mime.php:246)
in Resolve 4.01.240
Dec 07, 2011
Eelco Leenen
Hi,
Is there a specific reason why no files are available for Zend Loader on PHP 5.3?
Zend Guard 5.5 will give you the option within the same license to encode files for Zend Optimizer (5.2) or Zend Loader (5.3), so I can't really see the issue here.
Best regards,
Eelco
Dec 07, 2011
lexore
Zend Guard 5.5 release came out two weeks ago.
I think, you just have to wait a little.
Dec 07, 2011
Eelco Leenen
Hi,
Not quite, Zend released Guard 5.5 with 5.3 support in Nov 2010. The runtime loader (Zend Guard Loader) was released somewhat later if I'm correct.
Best regards,
Eelco
Dec 09, 2011
Mike
Just wanted to add here. Kayako and Apache in general runs MUCH better on PHP 5.3 with Ioncube. Just switched from Zend Optimizer and PHP 5.2 a few weeks ago and am no longer getting segfaults every 5 minutes in Apache logs.
I would strongly recommend against PHP 5.2 as Kayako has.
Note: PHP 5.3 requires you to set the server time zone in php.ini to prevent warnings in the logs.
Dec 12, 2011
Eelco Leenen
Hi Mike,
Segmentation faults can be caused by various things, it may be a combination of Apache modules / plugins which interfere with each other.
However, Kayako runs fine on PHP 5.2 with Zend Optimizer.
Regarding timezone settings, the requirement to set a timezone is since PHP 5.1.0. Since 5.3.0, PHP throws an e_warning instead of an e_strict. The reason you see them now is that you probably didn't log e_strict-level errors.
Best regards,
Eelco
Jan 25, 2012
Brandon Skrtich
Also to use PHP GD functions to generate the CAPTCHA image you must have FreeType installed. Otherwise, you will get no CAPTCHA image displayed. This should be added to the requirements list.
Jan 30, 2012
Simran Sangha
Thank you Brandon - we've added that.