Live Chat Server

Realtime blazing fast communication server for live chat built on top of nodejs.


First of all thank you for purchasing this plugin. I hope you feel awesome ūüôā If you need any help regarding setup, installation and/or getting started which is beyond the scope of this document, please let me know via tha contact form at

Introducing Socket.IO server for Awesome Live Chat running on Nodejs. This will allow real-time chat sessions between operators and customers. Not happy with AJAX long polling? Try this and you will love it.

Did you know?

The server also comes with an updater script to ease the flow of updating instantly whenever there are updates available.

For just $14

Buy Now


  1. Firstly, you need the Awesome Live Chat WordPress plugin.
  2. Secondly, you need an online server/host where you can deploy the chat server. Either your own cloud host (like DigitalOcean droplets) or Heroku dynos, OpenShift gears, among many others. Heroku and OpenShift allow free app hosting with ssl communication.
  3. You will NOT be able to deploy this server on shared hosting.

Note, that the setup process is not as simple as setting up a wordpress plugin. If in doubt, please let us know before purchasing.


The following are the tools you should feel comfortable to use:

  1. Git
  2. Nodejs
  3. Terminal


First of all, you need to extract the awesome-live-chat-server directory out from the zip archive.

To test that it works, open up terminal cd into this directory and run pulse command.

where is the url to your wordpress homepage.

If you see any errors, remove/delete the node_modules directory and run the following install command

Run the pulse command again, this time it should work.

Now, to showcase the setup of the server, we will be deploying the server on a free dyno by Heroku and you will see how to set things up. Note that Heroku provides free usage on an app utilizing a SINGLE DYNO.

After registering, you will be presented by your dashboard:

heroku-dashboardGo ahead, click on the  icon located at the top right corner to create your app that will host the server.

You will now see a page where you need to enter a name for the app. This can be any name you wish (should not be taken by anyone else). Click the Create App button and your app will be created.


Following this, you will be presented by a setup tutorial which is quite intuitive to understand. Let’s set our server now.

Heroku Toolbelt

Heroku works by hosting the files on your computer/host, which may include your home pc. To do so, you need to install the Heroku Toolbelt on your machine. This toolbelt is available for any modern OS, so you may install the one you need.

After you have installed the toolbelt on your machine, proceed with the following:

1. Open up command prompt (cmd) or a terminal and cd into the directory where you have your socket server (the one you purchased).

2. Run the following command and enter your Heroku credentials.

3. You will need to initialize git in this directory.

4. Add the remote app (the one you created at heroku) to this local git repo.

5. Finally this will deploy the server to Heroku and make it run.

The server is now up. At the end of the push, you will see your host url.


As you see, i received as my host url. Yours may differ depending on the app name you chose.

Environment variables

There is one step left before the server should work. You need to setup an environment variable to tell the server where you website is. The following steps illustrate this:

1. Click on your app in your dashboard.


2. Click the settings tab.


3. Click on the edit button.


4. Enter WEBSITE in the first space and in the second space. Finally hit the save button.


This will setup the environment variable required in order for the server to connect to your website.

Now back to the terminal, restart the server.

Turning on socket

The only thing left is to enable the socket server in the plugin settings.

To do that, head over to the Awesome Live Chat plugin settings page at and setup these options.


Choose Yes to use the socket server, enter the url where Heroku is hosting the server for you. The port may be left blank for Heroku.

You now have a real-time/instant chat support for your website visitors.


The server also comes bundled with an updater script which you may utilize.

Install node

You need to install nodejs on your local machine for this to work. Its a simple process and works cross platform. Download the relevant package and install it on your local machine.

To update the server, first cd into the directory.

Take a look at the different options you may use. This command will show the help screen.

The first thing you need to do, is to verify the plugin with your purchase key. To do so, run the following command.

Once you are verified, you may update the server by issuing the following command.

To update to a specific version, do as follows.

If you just need to check if there is a version available, use

To get information on a specific version, do

You might be wondering of the tedious task of entering the purchase key. To solve this, you may set an environment variable, just as we did for the WEBSITE variable for setting up the server.

The key phrase to use is LICENSE_KEY and the value will be your purchase key.

Note that environment variables can also be set in a .env file. Create a .env file in the root of the folder and enter the variables, for e.g. as follows:

Self Hosting

There is an equal possible chance that you may want to host and deploy the server under your own VPS (like digitalocean, ec2).

There is a fairly neat tutorial on how to set that up here: