Skip to content
This repository

Countly Mobile Analytics Server

branch: master
Octocat-spinner-32 api Release v13.10 October 18, 2013
Octocat-spinner-32 bin Update September 25, 2013
Octocat-spinner-32 frontend Release v13.10 October 18, 2013
Octocat-spinner-32 log Fix required empty directories May 28, 2012
Octocat-spinner-32 .gitattributes Release v12.05.1 May 28, 2012
Octocat-spinner-32 CHANGELOG Release v13.10 October 18, 2013
Octocat-spinner-32 LICENCE Update LICENCE January 18, 2014
Octocat-spinner-32 Update October 10, 2013

What's Countly?

Countly is an innovative, real-time, open source mobile analytics application. It collects data from mobile phones, tablets and other internet-connected devices, and visualizes this information to analyze mobile application usage and end-user behavior. There are two parts of Countly: the server that collects and analyzes data, and mobile SDK that sends this data.

Countly dashboard screenshot

Which mobile operating systems does Countly support?

Countly supports top-notch devices, including iOS, Android, Windows Phone and Blackberry. Below you can find Countly SDK repositories. Each SDK has its own installation instructions.

How do I install Countly server?

You can either download all files from Sourceforge, or get code from Github (this page).

We provide a beautiful installation sript (bin/ with countly-server package that installs and configures everything required to run Countly Server.

If you feel like doing things manually, or need to upgrade Countly from a previous version, please take a look at the installation articles from


We develop and test Countly on Ubuntu with MongoDB, Node.js and nginx. Installation script only needs a clean, decent Ubuntu Linux without any services listening to port 80 and takes care of every library and software (e.g MongoDB, Nginx, Node.js, Expressjs etc) required to be installed on Ubuntu Linux.

Countly community also provides scripts to install Countly on Mac OS X or Debian Wheezy

How do I upgrade my Countly server?

countly-server package includes an upgrade script (bin/ that takes care of the upgrade process.

API & Frontend

Quick overview of some important files and directories included in this package;

1. frontend/express/app.js

Countly dashboard that runs on Express server.

2. frontend/express/public/javascripts/countly

Contains seperate helper js files for each data visualization. For example countly.session.js is responsible for calculating session related metrics and interacts with api/api.js to retrieve data from the sessions collection.

3. api/api.js

Countly write and read API. Waits for write requests from the mobile SDKs and read requests from the Countly js helpers. Refer to Countly Server API Reference for details.

How can I help you with your efforts?

Glad you asked. We need ideas, feedbacks and constructive comments. All your suggestions will be taken care with upmost importance.

We are on Twitter and Facebook if you would like to keep up with our fast progress!


Something went wrong with that request. Please try again.