Countly Documentation

Countly Resources

Here you'll find comprehensive guides to help you start working with Countly as quickly as possible.

Upgrading Countly server

Upgrading to the latest Countly Edition usually does not involve any complicated operations. However, you need to know from which version you are upgrading to, and with which method you installed Countly previously. This is due to the reason that there are two different database models (before 15.03 and starting from & after 15.03) and two installation paths (Github and now non-supported Sourceforge downloads).

Important Note: For Countly Community Edition, Starting from version 15.03.02, all downloads will be from Github releases page.

Here's a very brief table providing a summary of installation scenarios

From version
To version

Greater than 15.03
(e.g 15.03.01, 15.03.02, 15.08, 16.02 etc)

15.08 and further

Regular update


Greater than 15.03

Old upgrade

Regular upgrade

If you are going to upgrade from a previous version (e.g 16.06 to 16.12), things are simple - just follow the path below. If there are more than two versions that you need to upgrade (e.g from 16.02 to 16.12), then please see Skipping versions when upgrading section below.

  1. Download Countly and extract contents over current Countly directory, overwriting all existing files

  2. Check if there is an upgrade folder for that specific version in bin/upgrade. If there is an script, then run it, just like the example below (replace 16.12 with your new version):

bash bin/upgrade/16.12/
  1. If there is no such directory and script inside that directory, then simply run:
#do upgrade files and restart countly
countly upgrade

Skipping versions when upgrading

If you are going to upgrade from a version that was released before last version (meaning, skipping version or more), then you will need to upgrade each version one by one.

You need to download latest release and extract it on your current Countly installation and then go to countly/bin/upgrade folder and execute all consecutive upgrade scripts.

Example: If you upgrade from 15.08 to 16.06, then you should do the following:

bash bin/upgrade/16.02/
bash bin/upgrade/16.06/

Old upgrade

Extract new package on old Countly directory, overwriting all existing files and then run following commands:

# Go to your countly directory (depends on your installation)
cd countly

# Install new depdendencies, if any
npm install

# Prepare production files
grunt dist-all

# Restart countly
stop countly-supervisor
start countly-supervisor

Upgrading Countly server