Countly helps you get insights from your application. Available self-hosted or on private cloud.
Clone or download
ar2rsawseen Merge pull request #734 from prikshittekta/puppeteer-ssl-issue
self signed ssl issue resolved - puppeteer
Latest commit 6a2e442 Nov 15, 2018
Failed to load latest commit information.
.github Update Oct 1, 2018
api self signed ssl issue resolved - puppeteer Nov 15, 2018
bin [eslint] fixes Nov 9, 2018
extend [eslint] more fixes of the merged files Sep 26, 2018
frontend/express [frontend] compare ids as strings Nov 15, 2018
log Fix required empty directories May 28, 2012
plugins [server-stats] eslint fixes Nov 12, 2018
test Merge pull request #697 from frknbasaran/validate-args Oct 4, 2018
.codacy.yml Merge branch 'master' into next Aug 8, 2018
.dockerignore [docker] Adding more to dockerignore Aug 24, 2018
.eslintrc.json Adding root eslint config Sep 5, 2018
.gitattributes Update .gitattributes Dec 3, 2014
.gitignore Merge branch 'next' into dynamic-widgets Jun 18, 2018
.travis.yml Merge branch 'master' into next Apr 11, 2018
AGPLv3 better elaboration about licensing & add FAQ URL Feb 16, 2017 [Changelog] Nov 12, 2018 Added instructions on using Vagrant Jan 10, 2018
Dockerfile docker: remove running migrations with startup, instead run it manually Jun 5, 2017
Dockerfile-core [docker] Adding nomongo option Sep 11, 2018
Gruntfile.js [SERVER-1127] Cross site scripting prevention. Nov 7, 2018
LICENSE add licensing faq URL, wrap lines for readability Feb 16, 2017 Update Oct 17, 2018
Vagrantfile Added Vagrantfile Jan 10, 2018
deploy-key.enc [travis] correct encrypt Apr 6, 2018
inch.json [inch] documentation analysis Sep 27, 2018
jsdoc_conf.json Update jsdoc_conf.json Sep 6, 2018
nyc.config Adding nyc code coverage functionality Sep 5, 2018
package.json [version] 18.08.2 Nov 9, 2018

Countly Analytics

Build Status Codacy Badge Install Countly on DigitalOcean


WebsiteDocsTry demoSlack groupCommunity forum

Table of Contents

What is Countly?

Countly is an innovative, real-time, open source mobile & web analytics, rich push notifications and crash reporting platform powering more than 2500 web sites, 14000 mobile applications and several tens of thousands of desktop applications as of 2017 Q3. It collects data from mobile, desktop, web apps including Apple Watch, TvOS and other internet-connected devices, and visualizes this information to analyze application usage and end-user behavior.

With the help of Javascript SDK, Countly is a web analytics platform with features on par with mobile SDKs. For more information about web analytics capabilities, see this link.

There are two parts of Countly: the server that collects and analyzes data, and an SDK (mobile, web or desktop) that sends this data. This repository includes Countly Community Edition (server side). For more information other versions (e.g Enterprise Edition), see comparison of different Countly editions

Click on the below image for a 1 minute video introduction to Countly (opens Youtube);

Countly Community Edition - Video

What is included?

This repository includes server-side part of Countly, with following features:


What can Countly track?

Countly can collect and visualize data from iOS, Android, Windows Phone devices, desktop applications (Windows, Mac OS) and web applications. You can find a list of official and community supported Countly SDK libraries here. Each SDK has its own installation instructions.

Built with

  • MongoDB One of the most popular NoSQL databases
  • Node.js An open-source, cross-platform JavaScript runtime environment for developing a diverse variety of tools and applications.
  • Express.js Popular Node.js web application framework
  • Linux What we love using ;-)

Plus lots of open source libraries!


Security is very important to us. If you discover any issue regarding security, please disclose the information responsibly by sending an email to and not by creating a GitHub issue.

What makes Countly unique?

Countly is a privacy-focused and 360-degree analytics approach with several, unique values:

  • Real-time mobile analytics, web analytics and push notifications.
  • Your data, your rules - since you can install Countly on your own server, or let us do a private cloud deployment for you.
  • Configurable and extensible via open source plugins.
  • Modern and easy to use web dashboard with a focus on user experience, helping to get complex insights easily.
  • Tracking more than 2500 web sites and 14000 mobile applications.
  • Collecting more than 60 billion datapoints worlwide.

Differences between Community Edition & Enterprise Edition

  • Audience: Community Edition is for product managers, developers and analytics enthusiasts, whereas banks, operators, healthcare companies and businesses that run the world's leading websites choose Enterprise Edition.
  • Deployment: Community Edition deployments are for environments where the information stored is not critical since it does not include professional assistance. You must have a qualified technician. Enterprise Edition is for corporate environments that require availability and reliability where intellectual capital is critical.
  • Technology: Community Edition has a number of limitations, including no corporate support for sharding, replica sets or installation.
  • Guarantee: Community Edition is on the bleeding edge regarding version upgrades and with no bugfix guarantee. Enterprise Edition has bugfix guarantee, immediate resolution, verified builds, on-site and automatic version upgrades.
  • Features: Enterprise Edition has more features compared to Countly, with a focus on end-to-end analytics and marketing platform. Additional features include but not limited to automated push notifications, drilling on the raw data, user profiles, in-app purchase analytics, retention & engagement, user flows, cohorts and custom dashboards.

Installing and upgrading Countly server

Countly installation script assumes it is running on a fresh, decent Ubuntu/CentOS/RHEL Linux without any services listening on port 80 or 443 (which should also be open to incoming traffic), and takes care of every library and software required to be installed for Countly to run.

There are several ways to install Countly:

  1. The following command will download and install Countly on your Ubuntu or CentOS server.

    wget -qO- | bash

  2. If you have a Digital Ocean account, click here and install on Digital Ocean with a single click.

  3. For bash lovers, we provide a beautiful installation script (bin/ in countly-server package which installs everything required to run Countly Server. For this, you need a stable release of this repository available here.

  4. Countly Community Edition also has Docker support - see our official Docker repository and installation instructions for Docker

If you want to upgrade Countly from a previous version, please take a look at upgrading documentation.

API and Frontend

Countly has a well defined API, that reads and writes data from/to the Countly backend. Dashboard is built using the read API, so it's possible to fetch any information you see on the dashboard using the Countly API. If you are interested in creating new reports or visualisations in the UI, we recommend checking out the next section for creating plugins.

Extensibility and plugins

Countly is extensible using the plugin architecture. We suggest you read this document before creating your plugin. We provide support to companies with know-how in need to create their own plugins.

How can I help you with your efforts?

  1. Fork this repo
  2. Create your feature branch (git checkout -b my-new-super-feature)
  3. Commit your changes (git commit -am 'Add some cool feature')
  4. Push to the branch (git push origin my-new-super-feature)
  5. Create a new pull request

Also, you are encouraged to read an extended contribution section on how to contribute to Countly

0 1 2 3 4 5 6 7


If you liked Countly, why not use one of our badges and give a link back to us, so others know about this wonderful platform?

Countly - Product Analytics

<a href="" rel="nofollow"><img style="width:145px;height:60px" src="" alt="Countly - Product Analytics" /></a>

Countly - Product Analytics

<a href="" rel="nofollow"><img style="width:145px;height:60px" src="" alt="Countly - Product Analytics" /></a>