Telemetry

The anonymous daily report a self-hosted install sends, what it contains, and how to turn it off.

A self-hosted Meteroid install sends one anonymous report a day. It tells us how many installs are running, which versions are in use and roughly how much they bill, so we know where to spend our time. It contains counts, never your data: no names, emails, ids of your customers or invoices, credentials or hostnames. The code that builds it is open source (instance_telemetry in the repository).

​

Turning it off

Set METEROID_TELEMETRY=off (or DO_NOT_TRACK=1) on the worker, which sends the report. With the Helm chart, set global.usageTelemetry: false. To see what would be sent instead, set METEROID_TELEMETRY_DEBUG=1: the worker logs the report every hour and never sends it.

​

What the report contains

The worker sends it to https://api.metero.id/oss/v1/telemetry, the host installs already call for exchange rates. The install is identified by a random UUID stored in your database, unrelated to your license. The collector keeps the country derived from the IP address, never the address.

{
  "schema": 1,
  "instance_id": "5f0c3a9e-8b1d-4c2e-9f3a-0d1e2f3a4b5c",
  "sent_at": "2026-11-02T03:12:00Z",
  "install": { "installed_on": "2026-10-14", "first_version": "v2.0.0" },
  "build": { "version": "v2.0.1", "edition": "oss", "os": "linux", "arch": "x86_64" },
  "deployment": "docker-compose",
  "infra": { "postgres_major": 18, "object_storage": "s3" },
  "usage": {
    "organizations": 1,
    "tenants_live": 1,
    "tenants_other": 2,
    "users": 4,
    "customers": 812,
    "subscriptions_active": 640,
    "plans_published": 6,
    "billable_metrics": 9,
    "invoices_finalized_30d": 701,
    "currencies": ["EUR", "USD"],
    "billed_30d_usd": "100k-1M"
  },
  "integrations": ["hubspot", "stripe"],
  "modules": []
}

Customers, subscriptions, plans, metrics, invoices, currencies and integrations are counted in Production tenants only. billed_30d_usd is a band (0, <1k … 10M+), never the amount, and object_storage is the URL scheme only.

The license usage report an Enterprise install sends under its license is separate from this one.