Usage statistics

Ce contenu n’est pas encore disponible dans votre langue.

A self-hosted Engram instance sends a small, anonymous daily ping so we can count how many instances exist and which platforms they run on. It is on by default, it never contains your notes, and one environment variable turns it off.

Turning it off

Either of these stops the ping:

How	Effect
`ENGRAM_TELEMETRY=false`	Never send. Overrides the setting below.
Administration → Usage statistics	Untick Send anonymous usage stats.

ENGRAM_TELEMETRY=true (or leaving it unset) leaves the decision to the Administration setting.

Engram does not hide the default. The container logs a line at boot saying the ping is on and how to turn it off, and Administration → Usage statistics shows the setting and the exact payload.

An instance with no outbound internet access keeps working normally; a failed ping is dropped and nothing retries.

Exactly what is sent

One HTTPS POST per day to https://api.engram.page/api/telemetry/ping with this body, and nothing else:

{
  "id": "0192f3a0-7b1e-7c3a-9d2e-5a1b2c3d4e5f",
  "version": "0.5.518",
  "os": "linux",
  "arch": "amd64",
  "runtime": "docker"
}

Field	Meaning
`id`	A random UUID generated once and stored in your instance database. It is not derived from your hostname, hardware, or any user data.
`version`	The Engram version you run.
`os`	`linux`, `darwin`, `windows`, or `other`.
`arch`	`amd64`, `arm64`, or `other`.
`runtime`	`docker` or `source`.

The same payload is shown under Administration → Usage statistics, so you can read it before you decide.

What is not sent

Notes, vault names or counts, user accounts or emails, hostnames, and anything else about how you use the instance.

Your IP address

The collector does not store your IP address. The server uses it in memory to rate-limit requests and discards it. As with any request to a website, the network provider in front of api.engram.page (Cloudflare) handles the connection.

What we use it for

Counting active instances (those that pinged in the last 30 days) by platform and version, to decide what to test and support.

How long we keep it

A record is deleted 35 days after its last ping. An instance that stops pinging, because it was shut down or you turned the ping off, drops out of our data within about a month.

Questions

Email privacy@engram.page. If you are asking about a specific instance, include its install ID, shown under Administration → Usage statistics.