ComeCat is universal chat platform for team chat and user support.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


ComeCat is open source messenger for team chat and for live chat support. Everything you need for communication is in one place.


Please signin from here. You can try all features.


  • Team Chat

  • Live Chat

    • On Your Web Site
    • Chat with guests
  • Messenger Integration

    • Facebook Messenger
    • Line
    • WeChat
    • Viber
    • Kik
    • Telegram
    • Twilio
  • Bot API Integration

    • IBM Watson
    • Dialog Flow
    • And a lot of Bot API is comming !!

For further detail please check our website and documentation.

This repository contains following.

  • Comecat Backend ( under src/server )

    • Backend provides API and all business logics. Spika uses HTTP API and Websocket.
  • Comecat Web Client ( under src/client )

    • Web client is where you login in and chat with your team & customer.
  • Comecat Web Connector ( under src/webconnector)

    • Web Connector is the unique URL where you can share to people and everyone has direct chat with you. As also you can include simple JS into your web site and you can chat with your web site visitors.

System Requirements


  • 2GB RAM
  • 128FB Storage


  • NodeJS : v9.0
  • MongoDB : v3.6
  • Redis Server : v2.8.4

Quick Installation

This instruction shows how to deploy server and build frontend in Ubuntu16.04. Probably almost same for Ubuntu18.04. ComeCat should work on all Linux distributions please understand what you need from this instruction.

This installation is for minimum setup for development environment. So I skipped everything about security.


  1. Install libraries
sudo apt-get update
sudo apt-get install -y git imagemagick build-essential libfuse-dev libcurl4-openssl-dev libxml2-dev mime-support automake libtool python redis-server
  1. Install NVM
curl -o- | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/" ] && \. "$NVM_DIR/"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
nvm install node
nvm use node
  1. Install MongoDB 4.0
sudo apt-key adv --keyserver hkp:// --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb [ arch=amd64,arm64 ] xenial/mongodb-org/4.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org
sudo service mongod start

Please don't forget to setup access credentials for production environment

  1. Clone From Git
git clone
cd comecat
npm install
cp src/server/lib/init-sample.js src/server/lib/init.js

Create upload folder

mkdir public/uploads

Run installer

node src/console/install.js

Start server

node src/server/main.js

If everything is installed correctly server start running in port 8080. So please try to open http://[yourhost]:8080/admin/ and check admin console is opened.

  1. Build Frontend

Now you have to build frontend and webconnector.

npm run build

This process will take a long if you are running in low spec servers.

Then check you can open http://[yourhost]:8080/

  1. Build WebConnector
cd src/webconnector/
npm install
npm run build


src/server/init.js = "localhost";
Config.port = 8080;

Config.serviceURL = "http://localhost:8080"; // frontend url

Config.databaseUrl = "mongodb://localhost/comecat"; // mongodb settings

Config.redis = { // redis settings
    host: "localhost",
    port: 6379

Config.mailgunSettings = {
} // mailgun is used for email activation


export const serverBase = "http://localhost:8080";


export const baseURL = "http://localhost:8080";
export const SpikaAPIKey = "GtZX9bkKKiWpJKauL06ugOCZS2BwrJEY";
export const SpikaWebSocketURL = 'ws://localhost:8080/spikaenterprise';


var baseURLSrc = "http://localhost:8080";