Download & Install Countly

This document explains how to install Countly server.


Countly can be installed on Ubuntu Linux, running 10.04 LTS, 11.10, 12.04 and 13.04. We highly recommend that you use a dedicated VPS for Countly. By default, Node.js (the web server Countly needs) need to run on port 80, so make sure this port is free, i.e Apache is not running.

In this article, we will not be talking about securing your web server, like disabling root ssh, private keys, closing default ports etc. for the sake of keeping things focused.

IMPORTANT NOTE: Easy installation script provided inside ZIP file (countly/bin/ takes care of all the steps listed below. We strongly suggest you use that script instead.

This is how you'll fire the easy installation script that comes with Countly:

cd bin

If you are brave enough, go on :-)

1. First things first

Update your repository information.

sudo apt-get update

2. Install python-software-properties

sudo apt-get install python-software-properties

3. Add Node.js & MongoDB repos


sudo apt-add-repository ppa:chris-lea/node.js


sudo echo "deb dist 10gen" > /etc/apt/sources.list.d/mongodb-10gen-countly.list
sudo apt-key adv --keyserver --recv 7F0CEB10

4. Update package list once more

sudo apt-get update

5. Install Nginx

sudo apt-get install nginx

Nginx web server is used as a proxy to our API and Dashboard nodes. We will configure and start our nginx server after completing all package installations.

6. Install Node.js

sudo apt-get install nodejs

Node.js is our primary web server that our API and Dashboard nodes run on.

7. Install MongoDB

sudo apt-get install mongodb-10gen

8. Install Supervisor, Imagemagick, Sendmail and Build Essential

sudo apt-get install supervisor
sudo apt-get install imagemagick
sudo apt-get install sendmail
sudo apt-get install build-essential

Supervisor is the process monitor that is used to run API and Dashboard processes of Countly. If any of them die Supervisor will restart the process and keep things working. Imagemagick is used for processing your application icons. Build essential package contains necessary tools to compile some node modules and libraries Countly depends on.

9. Extract ZIP file

If you haven't downloaded Countly yet, do it now. Copy the zip file in a directory that can be used to serve files (e.g /usr/local).

Extract the file:


10. Install Node.js time module

cd countly/api
sudo npm install time

11. Create Supervisor upstart script

Create /etc/init/countly-supervisor.conf with the below contents;

description     "countly-supervisor"

start on runlevel [2345]
stop on runlevel [!2345]

exec /usr/bin/supervisord --nodaemon --configuration YOUR_PATH_TO_COUNTLY/countly/bin/config/supervisord.conf

Don't forget to change YOUR_PATH_TO_COUNTLY to the directory where you have extracted the Countly server ZIP package.

12. Create API and Dashboard configuration files

cp countly/api/config.sample.js countly/api/config.js
cp countly/frontend/express/config.sample.js countly/frontend/express/config.js

13. Start Supervisor

Supervisord starts api and app nodes that corresponds to API and Dashboard.

start countly-supervisor

14. Create frontend JS configuration from sample

cp countly/frontend/express/public/javascripts/countly/countly.config.sample.js countly/frontend/express/public/javascripts/countly/countly.config.js

15. Configure & start Nginx

Nginx default configuration file is located under /etc/nginx/sites-enabled/default. We will take a backup of the existing file first and add our own configuration file.

cp /etc/nginx/sites-enabled/default /YOUR_BACKUP_DIRECTORY_OF_CHOICE
rm /etc/nginx/sites-enabled/default
vi /etc/nginx/sites-enabled/default

And add the below contents to the file;

server {
  listen   80;
    server_name  localhost;

    access_log  off;

    location = /i {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP $remote_addr;

    location ^~ /i/ {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP $remote_addr;

    location = /o {

    location ^~ /o/ {

    location / {
        proxy_set_header Host $http_host;

We have added a server configuration for localhost. You need to change localhost to your domain ( for ex.) if you want to access your Dashboard and API from your domain.

Save and exit from vi;


Start Nginx server;

/etc/init.d/nginx start


You have successfully installed Countly on your server. Now http://YOUR_SERVER_IP_OR_DOMAIN in order to create your admin account and login to your dashboard. Also do not forget to download client SDKs using button below:

Have Fun! :)

comments powered by Disqus

Subscribe to Countly mailing list