Skip to content

The install count

The NetherNode README shows how many installs are active. That number only includes installs whose owners chose to be counted. It’s off unless you turn it on.

Only in the panel: Settings › Anonymous stats (owners only). There’s no configuration setting or environment variable to turn it on. Settings shows where reports go; install_count.url can point them somewhere else.

Installs from before 0.2.2 could turn it on with install_count.enabled or NETHERNODE_INSTALL_COUNT__ENABLED. If that’s still set, it’s carried over to the Settings switch once, and ignored after that; remove it.

Turning it off deletes the install ID, so turning it back on later counts as a new install.

About once a day (and shortly after you turn it on), NetherNode sends one HTTPS request to the counter with exactly this, which Settings also shows:

{"id": "3f1c2b9a-7d4e-4a6b-9c2d-1e0f5a7b8c9d", "version": "0.1.0"}
  • id is a random UUID made on your machine when you turn counting on. It isn’t derived from anything: not your hardware, hostname, account or address.
  • version is NetherNode’s version.

Nothing else is sent: no names, hostnames, server or player information, settings, or usage.

The counter is a small open-source Cloudflare Pages project (counter/ in the NetherNode repository) at https://nethernode-installs.pages.dev. It stores each install ID, its version, and the day of the last report, and forgets an install after 90 days without one. It keeps no request logs and doesn’t store IP addresses, though like any web request, the connection itself comes from your address. The badge counts IDs heard from in the last 30 days.