Skip to content
Forkshelf
Menu

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.sh script 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)