This documentation is for the legacy version of Kiwi IRC, kept here only for reference.

See here for the actively developed Kiwi IRC

Installing the Kiwi Server

Note: This requires Node.js to run. Make sure you have installed Node.js first! http://nodejs.org/download/

  1. Download the Kiwi source or clone the git repository
    $ git clone https://github.com/prawnsalad/KiwiIRC.git && cd KiwiIRC

  2. Install the dependencies
    $ npm install

  3. Copy and edit the configuration as needed
    $ cp config.example.js config.js
    $ nano config.js

  4. Make sure the client code is built
    $ ./kiwi build

Enabling SSL

You can enable SSL in your kiwi server to have secure communication between the server and browsers. An example SSL server can be found in config.example.js.

You must have a SSL certifcate and key file. You can generate a self-signed certificate by running the following:

openssl genrsa -out server.key
openssl req -new -key server.key -out csr.pem
openssl x509 -req -days 9999 -in csr.pem -signkey server.key -out cert.pem
rm csr.pem

Running

From the source folder: $ ./kiwi start

You can also run kiwi in the foreground to see any output by using the -f flag. Eg: $ ./kiwi -f

Open your new Kiwi instance in your browser. By default: http://localhost:7778/