Installation Instructions

We offer professional installation but many people like to install their own applications or are behind a firewall that does not allow external access. Follow the instructions below and you should not have any trouble. If you do run into difficulty do not hesitate to ask for assistance.

Quick Install

1. Unzip the file on your local harddrive.
2. Upload the cgi-script directory and its entire contents (and directory structure) to the root directory of your website.
3. CHMOD the csChatRBox.cgi file to 755
4. Open csChatRBox.cgi from your webbrowser where you uploaded it to your site to go into auto-setup mode.
5. Click save. If you keep returning to the auto-setup screen, the chmod the csChatRBox directory and banner subdirectory to 777 and then repeat from step 4.
6. That's it.

Detailed Installation Instructions

1. Unzip the file and transfer to your server with the following directory structure:

/cgi-script <-- script directory
/cgi-script/csChatRBox <-- csChatRBox directory
/cgi-script/csChatRBox/images <-- images directory

csChatRBox.cgi should be located at
[root url]/cgi-script/csChatRBox/csChatRBox.cgi
where [root url]
is the URL to your website. Example:

2. Chmod csChatRBox.cgi to executable (chmod 755). Ask your server administrator for assistance if required.

3. If your Perl executable is not located at /usr/bin/perl, edit the first line of csChatRBox.cgi to reflect the true location.

4. Run csChatRBox.cgi from your webrowser.


When the script is run for the first time, it goes into setup mode. A setup screen will appear where you can verify and modify the setup variables. Most of the time, there will be no need to modify any of these variables.

When you click the save button on the installation screen, it should automatically create a file called setup.cgi which will look something like:

$cgiurl = '';
$cgipath = '/www/vhosts/';

Note: If you keep returning to the setup screen then your web server doesn't have the ability to write to your directories. If that is the case, a work-around is to chmod the csChatRBox  directory to 777.

Hint: Deleting the setup.cgi file will trigger the script to go back into setup mode.

Installing the script in your cgi-bin directory
(note: we recommend that you use this setup only if you are unable to run scripts outside your cgi-bin directory. Its much easier to follow the above instructions that it is to install it in your cgi-bin directory)

Due to the limitations of cgi-bin directories, you'll need to create 2 directories when installing the script in the cgi-bin directory. One directory inside cgi-bin that will contain the script and a directory outside the cgi-bin directory where all the other files will reside. For example, in your cgi-bin directory upload the csChatRBox.cgi and libs.cgi file in a csChatRBox subdirectory.. i.e. cgi-bin/csChatRBox

Create a directory outside your cgi-bin directory like cgi-script/csChatRBox and upload the remaining files there. Run csChatRBox.cgi from your webbrowser to auto-create the setup.cgi file. Add the following variables to reflect the directory outside the cgi-bin directory.

$htmlpath = '/path/to/csChatRBox/directory';
$htmlurl = '';

So, for example, your final setup.cgi file ( that should reside in your cgi-bin/csChatRBox directory ) should look something like:

$htmlurl = '';
$htmlpath = '/www/vhosts/';
$cgiurl = '';
$cgipath = '/www/vhosts/';

If you have any problems or questions with the installation, don't hesitate to email We also offer installation services.

Usage Instructions

 Go to [root url]/csChatRBox.cgi where [root url] is the location of the script.


Choose a username and a color and click the login button.

The $refresh variable in the setup.cgi file controls the number of seconds to pass before the browser checks for new messages. You can increase or decrease this number, however, be aware the lower the number the more strain it will be on your server.. The higher the number, the less strain.

TIP: To clear out the messages, you can delete the msgfile.cgi located in either the $cgipath or $htmlpath directories.

If you experience any problems or questions, please feel free to email