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

# Configure telemetry

> Understand the anonymous Handshake events and disable them when required.

Release builds can send two anonymous events:

* One install event after the first successful guided setup.
* One heartbeat with a performed weekly release check.

The events do not contain session content, project names, file paths, prompts,
or account information.

For the complete field list, see [Privacy](/reference/privacy).

## Disable telemetry

Set this environment variable before you run Handshake:

```bash theme={null}
export HANDSHAKE_NO_TELEMETRY=1
```

When this variable has a value, Handshake does not send telemetry and does not
create `~/.handshake/telemetry_id`.

Add the variable to your shell profile if you want the setting to apply to
future terminal sessions.

<Note>
  The GitHub release check is separate from the anonymous telemetry event.
  Handshake uses the release check to report available updates.
</Note>