🔗 Quick links
🌟 What is Countly?
Countly is a privacy-first, AI-ready analytics and customer engagement platform built for organizations that require full data ownership and deployment flexibility.
Unlike traditional SaaS-only analytics tools, Countly can be deployed on-premises or in a private cloud, giving you complete control over your data, infrastructure, compliance, and security.
Teams use Countly to:
- Understand user behavior across mobile, web, desktop, and connected devices
- Optimize product and customer experiences in real time
- Automate and personalize customer engagement across channels
With flexible data tracking, customizable dashboards, and a modular plugin-based architecture, Countly scales with your product while ensuring long-term autonomy and zero vendor lock-in.
Built for privacy. Designed for flexibility. Ready for AI-driven innovation.
🚀 Countly Plans
Countly Lite
- Core analytics and essential features
- Free to use under an open-source, non-commercial license
- Self-hosted deployment
- Ideal for individuals and small teams
Countly Enterprise
- Full analytics and engagement suite
- Advanced features, granular data access, SLA, and direct support
- Available as self-hosted or managed/private cloud
- Ideal for medium and large organizations with advanced compliance needs
Countly Flex
- Fully managed SaaS experience with dedicated Countly servers
- Region-based hosting selection
- Enterprise-grade features included, with optional add-ons
- Ideal for individuals and small-to-medium organizations wanting flexibility without infrastructure management
:pushpin: Note: Countly SDKs are identical across all editions.
For a detailed comparison of different editions please check here. To try the Countly Flex please visit this page.
📦 What is included in this repository?
This repository includes server-side part of Countly, with the following features:
- Session, view and event collection and reporting
- Crash/error reporting for iOS, Android, React Native, Flutter, NodeJS, Unity, Java and Javascript
- Rich and interactive push notifications for iOS and Android
- Remote configuration to adjust your app's logic, appearance, and behavior on the fly
- In-app ratings with customizable widgets
- Built in reports and customizable dashboards
- Email reports and alerts
- Hooks to send the data to external parties via email or webhooks
- Data Manager to plan and manage events and event segmentations
- Compliance Hub for consent collection and data subject request management
- User, application and permission management
- Read and write APIs
- Plugin based architecture for easy customization
📈 What can Countly track?
Countly can collect and visualize data from mobile, web and desktop applications. Using the write-API you can send data into Countly from any source. For more information please check the below resources:
🛠️ Installing and upgrading Countly server
Countly installation script assumes it is running on a fresh 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:
-
The following command will download and install Countly on your Ubuntu or CentOS server.
wget -qO- https://c.ly/install | bash
-
For bash lovers, we provide a beautiful installation script (bin/countly.install.sh) in countly-server package which installs everything required to run Countly Server. For this, you need a stable release of this repository available here.
-
Countly Lite also has Docker support - see our official Docker repository and installation instructions for Docker. To run it locally from this repository, use the included docker-compose.yml, which starts MongoDB, the Countly API, the Countly frontend and nginx (on port 80):
docker compose up -d
If you want to upgrade Countly from a previous version, please take a look at upgrading documentation.
🧩 API, extensibility and plugins
Countly has a well-defined API, that reads and writes data from/to the Countly backend. Countly dashboard is built using the read API, so it's possible to fetch any information you see on the dashboard using the API.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
