Self-host Countly
- GitHub stars
- 5,926, as of 8 Nov 2026
- Latest release
- 25.03.58, as of 8 Nov 2026
- Host needs
- Not stated in official docs
- Install method
- Install script; Docker
- One-click template
- None listed
Countly is product analytics that you can run on your own server. The self-hosted edition is called Countly Lite.
Countly is provided under "AGPL-3.0 with modified Section 7". The added Section 7 terms are about branding. You must keep Countly's logos and branding in the source code and in any interface end users can see, and you can't put other brands on a derivative work. Read the full text in LICENSE.md. The README describes Lite as "Free to use under an open-source, non-commercial license".
- Last commit: 6 Nov 2026 22:41 SGT, as of 8 Nov 2026. The repository is not archived.
Requirements
The install 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)".
The installer sets up MongoDB 8.0.
Countly's install guide could not be checked for CPU and memory figures, so none are given here.
Install methods
- The one-line installer for Ubuntu or CentOS,
wget -qO- https://c.ly/install | bash. - The
bin/countly.install.shscript in the countly-server package, which installs everything Countly Server needs. - Docker, through the official countly/countly-server image. The repo also ships a docker-compose.yml file and Kubernetes files under bin/docker/k8s/.
Hosting options
Countly Lite is self-hosted. Countly Enterprise is "Available as self-hosted or managed/private cloud", and Countly Flex is a "Fully managed SaaS experience with dedicated Countly servers" with region-based hosting. Enterprise code is not in the public server repo.
Backups and updates
The countly command line tool backs up the countly, countly_drill, countly_fs and countly_out databases with mongodump.
To restore, countly restoredb path/to/backup restores the database, countly restorefiles path/to/backup restores user and config files, and countly restore path/to/backup restores both.
Alternatives
See self-host Matomo.
Sources (fetched 30 Oct 2026)
- https://github.com/Countly/countly-server
- https://raw.githubusercontent.com/Countly/countly-server/master/LICENSE.md
- https://github.com/Countly/countly-server/blob/master/bin/scripts/mongodb.install.sh
- https://api.github.com/repos/Countly/countly-server
- https://github.com/Countly/countly-server/blob/master/bin/commands/countly.sh