This page describes required web server configuration that you need in order to install Kayako Fusion, Kayako Case or Kayako Engage.
Server software requirements
PHP 5.4 or later is required. PHP 5.5 is recommended as it the latest tested version.
MySQL version 5.0 or later (we recommend the very latest stable release)
IonCube or Zend Optimizer no longer required
As of Kayako 4.50, a PHP decoder is not required.
Any web server daemon - such as Apache, nginx, IIS which is fully compatible with the required PHP configuration.
These settings are done in the PHP configuration file "php.ini" of the server on which you are installing the helpdesk.
- max_execution_time: "600"
- max_input_time: "600"
- magic_quotes_gpc: "Off" (this setting is not a part of standard "php.ini" file supplied with PHP 5.4.x)
- 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)
- output_buffering: 4096
- file_uploads: "On"
- upload_max_filesize: "20M"
- post_max_size: "20M"
- max_file_uploads: "20"
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).
sql-mode : set to not strict.
max_allowed_packet : should be 64M (Minimum).
PHP caches and accelerators
Kayako accesses many scripts spread across many files for each connection. If you do not have a PHP cache, unless your web server is very finely tuned you will find the application to be less responsiveness. We strongly recommend that your web server has a PHP cache like xcache, apc or eaccelerator installed. We find that xcache is the easiest to install and most readily available, and use it ourselves.
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:
- gd with Freetype support
- MySQLi (required for PHP 5.5 and later)
Server hardware requirements
It is very difficult to quantify server hardware requirements for running Kayako. Our customers run their Kayako helpdesk on dedicated hardware, shared hardware or virtualized environments with restricted resource access.
Whichever environment you choose, assuming your database server will be run from the same hardware, the minimum hardware requirements for installing Kayako are:
- 2 GB of RAM (allowing for operating system processes)
- 20 GB of hard disk space available for your helpdesk (realistically, you should allow more than this for future growth)
- Access to the equivalent of a 2 GHz CPU core
So, what's recommended?
What we use at Kayako
The web application element of Kayako is platform independent, so the server requirements will remain the same for Windows as well as Unix/Linux servers. Which is best for you will depend on a variety of factors - including resources, expertise and what fits within your organization.
That said, we do have our own favourite configuration, which is in part used for our OnDemand platform:
What we use
It is well supported, secure, fast and easily configurable.
nginx is lightning fast and much more lightweight than Apache and IIS.
We use PHP version 5.5 for our hosted helpdesks
We find xcache to be lightweight and does the job very well.
What our customers use
Our customers use a huge variety of platforms and configurations, including both Linux and Windows. This is what we have identified to be the most common web server setup:
What we use
Linux (CentOS, Red Hat Linux, Debian, Ubuntu)
Linux is free, well supported, fast and secure. That's why it is the most popular Operating System amongst our customers and the world.
Apache (for Linux and Windows)
Apache is the world's most popular web server, and very easy to configure. It is prepackaged into most Linux distributions, making it the quickest web server to get started with.
We recommend 5.5 as it is the latest tested version.
Most likely based on our recommendation, and also because it is fairly simple to install.