To avoid accidental overwriting of
config.php which is located in
__swift/config/ and contains important data, the default name for the file is
config.php.new. You'll need to rename it to
config.php before continuing.
config.php file must be manually edited for configuration of the helpdesk's database connection.
The following variables in this file need to be edited:
This variable stores the address of your database server. On most installations the database server is located on the same computer as the web server, in this case the address should be set to "
This variable contains the username provided to you by your host for connecting to your database server.
The password that accompanies the database username should be entered here.
The name of the database that will contain your installation on the database server.
Once finished editing, save the file.
In order to activate the product, you'll need to download the
key.php file corresponding to your registered domain from My Kayako and upload it to the root folder (e.g.,
~/httpdocs/support/) in which the rest of the helpdesk files have been uploaded.
Set file permissions
Kayako needs write permissions for four directories inside the
__swift/. These directories are:
Please choose the section below that corresponds to your operating system if you are unfamiliar with changing permissions on directories.
On a Unix-based system, you'll want to use the
chmod command to set permissions to
777 on the aforementioned directories:
In IIS 6, you need to provide modify level permissions to "IUSR_MachineName" on above mentioned directories. For "IIS 7" and "IIS 8", "IUSR" account shall have modify level permissions on those directories. The "IUSR" account replaces the "IUSR_MachineName" account in "IIS 7" and above. Also you need to set full permissions for "IUSR" on "C:\Windows\TEMP" folder and set this path for "upload_tmp_dir = C:\Windows\TEMP" under PHP configuration file (php.ini). This is necessary because the attachments are temporarily stored under this folder before being sent. You can chose any folder and set the path under PHP configuration file accordingly.
Run the automatic setup system
The setup systemis located in the "/setup" directory inside the root directory of your helpdesk. (e.g., ~/httpdocs/support/setup). This would make the external (HTTP) URL something like 'http://mydomain.com/support/setup/', if you uploaded your helpdesk files to the '/support' directory.
To start setup, point your web browser to the URL as demonstrated and you will see the following screen:
Click on the Setup option from the menu and you will be prompted to review the license agreement as shown here:
Click on the I Agree button and setup will then check your web server to ensure that it meets the minimum system requirements for installation. If you encounter errors, follow the instructions on your screen. Otherwise, press Next:
Once setup has determined your server meets the minimum requirements, you will be prompted to enter the settings for the default administrator account and settings for your helpdesk:
Start Setup to begin the automated setup procedure.
The automated setup procedure will cycle through screens resembling this one until it has completed:
Once setup has completed, you will see the following screen: