> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meteroid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json theme={null}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.