Welcome to the Luxsys help center. Here you will find the full documentation, FAQ and support for Freelance Cockpit.

Server Requirements

Freelance Cockpit needs the following server extensions and modules:


Step 1

Connect to your web server using any FTP program (ie. FileZilla) or the web-interface of your web-host and upload all files and folders which are inside the "FC2 Application" folder from the .zip file you have downloaded from Codecanyon. If you like to install Freelance Cockpit 2 on your local computer using WAMP, make sure you first read Local Server Installation.

Step 2

The folder "files" and it's sub folders must have write permissions, so give the folder write permissions (777).

Step 3

Open your web browser and enter your domain plus "/install" i.e. http://www.your-domain.com/install

Step 4

Your System will now be checked. If your server meets all requirements, go ahead to the next step. If you have warning messages go to System Check Warnings.

Step 5

Now you need to enter your item purchase code. Click on the blue icon to get an idea where you can find your item purchase code.

Step 6

Enter your MYSQL configuration. If the database you have entered does not exist, the system will automatically try to create it. This might not work if your web-host does not allow to create new databases. Please use an existing database in this case or create a new database using the web interface of your hosing provider.

Step 7

If the database connection was successful, you need to fill the form with all your details and set some initial system settings.

Step 8

Congratulations! You have successfully installed Freelance Cockpit. Click on the Go to Login button and login with the default credentials. Do not forget to change your password!

If you get any warning messages on the success page, go to the Errors After Installation section in order to get those issues fixed.

Local Server Installation

WAMP Server

If you like to install Freelance Cockpit 2 on your local machine using WAMP Server you need to make sure to enable the apache rewrite_module. Click on the WAMP icon in your task-bar and click on Apache -> Apache modules -> rewrite_module

You also need to make sure that the Curl extension is loaded. Just open your php.ini (...wamp\bin\apache\apache2.2.22\bin\php.ini) and remove the semicolon in front of the following extension:


If rewrite_module is not active you will get an "Internal Server Error" message if you try to access the Freelance Cockpit installation tool.


Basic Cronjob

The basic cronjob should run at least once a day and is used in order to activate automated tasks like recurring invoices (subscriptions) and automatic database backup. Please refer to your web host providers FAQ in order to find out how to setup a cronjob/crontab (if your hosting package includes cronjobs).

The command should look like this:

wget http://www.your-domain.com/cronjob

Your hosting package does not include cronjob/crontab? No problem! There are many websites who offer free cronjob services. One of them is www.setcronjob.com.

Email Ticket Cronjob

The email ticket cronjob should run every 10 minutes and is used in order to activate email tickets.

The command should look like this (you can find your cronjob command in Settings->Ticket->Postmaster cronjob link):

wget http://www.your-domain.com/postmaster -O /dev/null

How to setup a cronjob in Plesk

If your web server is running Plesk you can check out the following instruction:

1. Go to Tools and Settings -> Scheduled Tasks

2. Click on Add new Task

3. Enter all the details like on the screen-shot below. Important - change the Cronjob link (Command) to your personal one. You can find it in Freelance Cockpit 2 under Settings -> Cronjob Note that you have to enter "wget" in front of the command link.

How to setup a cronjob in cPanel

Video by SiteServing

Paypal IPN

If you like to use the Paypal IPN feature make sure you have added the IPN link (can be found in Settings -> Paypal) to your Paypal account. Here is a short Youtube video which explains how to set the IPN link to your Paypal account

Video by WebifyWs

Ticket Email Setup

Here is a example for the ticket email setup using a gmail imap account:

Email SMTP Setup

In order to use an SMTP server for sending emails, you need to configure it in /application/config/email.php

$config['protocol'] = 'smtp';
$config['smtp_host'] = 'yourSMTPhost.com';
$config['smtp_port'] = '25';
$config['smtp_user'] = 'yourUser';
$config['smtp_pass'] = 'yourPassword';

Use the configuration below if your SMTP host needs to use SSL (php_openssl extension is required).

$config['protocol'] = 'smtp';
$config['smtp_host'] = 'ssl://yourSMTPhost.com';
$config['smtp_port'] = '465';
$config['smtp_user'] = 'yourUsername';
$config['smtp_pass'] = 'yourPassword';
$config['newline'] = "\r\n";

Use the configuration below if your SMTP host needs to use SSL and TLS (php_openssl extension is required).

$config['protocol'] = 'smtp';
$config['smtp_host'] = 'ssl://yourSMTPhost.com';
$config['smtp_port'] = '465'; // or port 587 for gmail
$config['smtp_user'] = 'yourUsername';
$config['smtp_pass'] = 'yourPassword';
$config['newline'] = "\r\n";
$config['smtp_crypto'] = 'tls';

Apache .htaccess Config

You have completed all steps of the installation wizard but there are error messages on the last step:
A common problem is the .htaccess file which is needed to rewrite all URL's to make them readable.
You can find the .htaccess file in the root folder of Freelance Cockpit. It's the same folder where the index.php file is located.

If you are using any OSX make sure you have enabled hidden files on your MAC.
The content of the .htaccess can be different from one server to another, so you might want to try one of configurations below.

If you have installed Freelance Cockpit into a sub folder on your server like http://your-domain.com/cockpit/ then you need to add the following line to the end of the .htaccess content
RewriteBase /cockpit/

RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
RewriteEngine On
# Removes index.php
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?/$1 [L]
RewriteEngine on 
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond $1 !^(index\.php|robots\.txt)
RewriteRule ^(.*)$ /index.php?/$1 [L]
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?/$1 [L,QSA]

Microsoft IIS Configuration

If you are using a Windows web server with IIS installed, the .htaccess won’t work so you need to edit the web.config like this (make sure the rewrite extension is installed on your IIS server http://www.iis.net/downloads/microsoft/url-rewrite):

<?xml version="1.0"?>
     <!-- Set the default document -->
        <remove value="index.php" />
        <add value="index.php" />
 <httpErrors errorMode="Detailed"/>
            <rule name="Main Rule" stopProcessing="true">
   <match url=".*" />
       <conditions logicalGrouping="MatchAll">
       <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
       <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
               <action type="Rewrite" url="index.php" />

Nginx Configuration

If you are running Freelance Cockpit on a nginx server, you need to use the following configuration instead of the .htaccess file:

location / {
    try_files $uri $uri/ /index.php?r=$request_uri;

location ~* \.(zip)$ {
  rewrite ^(.*)$ /index.php?/$1;  

Known Issues

A Database Error Occurred Error Number: 1140

  Mixing of GROUP columns ( MIN , MAX , COUNT ,...) with no GROUP columns is illegal if there is no GROUP BY clause

This error message comes up when your Mysql version in too old. Please contact your web hosting support in order to update to at least MYSQL version 5.x

Warning: Unexpected character in input: '\' (ASCII=92) state=1 in .../sparks/php-activerecord/0.0.2/libraries/phpactiverecord.php on line 48

Parse error: syntax error, unexpected T_STRING in .../sparks/php-activerecord/0.0.2/libraries/phpactiverecord.php on line 48

This error message comes up when your PHP version is too old. Please make sure your PHP version is at least Version 5.3

ERROR 404 - Page could not be found.

Check your .htaccess file for proper configuration.

You get a blank page after login

This mostly appears if your server is missing either the php_mysql or php_mysqli extension. Please contact your hosting provider in order to check if both extensions are installed and activated.

Error while sending email. Check your server settings!

This error means that there is no proper php mail() configuration so you need to setup an SMTP server in order to allow the system to send emails. To define your SMTP server, you need to open the file /application/config/email.php and in there you need to add the following lines:

$config['protocol'] = 'smtp';
$config['smtp_host'] = 'yourSMTPhost.com';
$config['smtp_port'] = '25';
$config['smtp_user'] = 'yourUser';
$config['smtp_pass'] = 'yourPassword';

System cannot sent emails with SSL SMTP hosts.

In order to you an SMTP server using a SSL connection you need to make sure that the php extension php_openssl is loaded on your server and that your email config in /application/config/email.php looks like below:

$config['protocol'] = 'smtp';
$config['smtp_host'] = 'ssl://yourSMTPhost.com';
$config['smtp_port'] = '465';
$config['smtp_user'] = 'yourUsername';
$config['smtp_pass'] = 'yourPassword';
$config['newline'] = "\r\n";

 Uncaught exception 'ActiveRecord\DatabaseException' with message 'Database host must be specified in the connection string. If you want to specify an absolute filename, use e.g...

This mostly appears if your mysql password contains a slash (/). Just use a MYSQL password without any slashes or backslashes.