2026-08-27 12:34:13 -04:00
|
|
|
---
|
|
|
|
|
title: Telemetry
|
|
|
|
|
---
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2025-03-10 15:58:20 -05:00
|
|
|
> [!NOTE]
|
|
|
|
|
> TL;DR: disable telemetry by setting <code>CODER_TELEMETRY_ENABLE=false</code>.
|
2023-10-19 15:50:20 -05:00
|
|
|
|
|
|
|
|
Coder collects telemetry from all installations by default. We believe our users
|
|
|
|
|
should have the right to know what we collect, why we collect it, and how we use
|
|
|
|
|
the data.
|
2022-10-03 23:03:46 -05:00
|
|
|
|
|
|
|
|
## What we collect
|
|
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
You can find a full list of the data we collect in our source code
|
2026-06-22 11:39:12 -04:00
|
|
|
[here](../../../coderd/telemetry/telemetry.go).
|
2023-10-19 15:50:20 -05:00
|
|
|
In particular, look at the struct types such as `Template` or `Workspace`.
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
As a rule, we **do not collect** the following types of information:
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
- Any data that could make your installation less secure
|
2024-11-12 11:24:13 -05:00
|
|
|
- Any data that could identify individual users, except the administrator.
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
For example, we do not collect parameters, environment variables, or user email
|
2024-11-12 11:24:13 -05:00
|
|
|
addresses. We do collect the administrator email.
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
## Why we collect
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
Telemetry helps us understand which features are most valuable, what use cases
|
|
|
|
|
to focus on, and which bugs to fix first.
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
Most cloud-based software products collect far more data than we do. They often
|
|
|
|
|
offer little transparency and configurability. It's hard to imagine our favorite
|
|
|
|
|
SaaS products existing without their creators having a detailed understanding of
|
|
|
|
|
user interactions. We want to wield some of that product development power to
|
|
|
|
|
build self-hosted, open-source software.
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
## Security
|
2022-10-03 23:03:46 -05:00
|
|
|
|
2023-10-19 15:50:20 -05:00
|
|
|
In the event we discover a critical security issue with Coder, we will use
|
|
|
|
|
telemetry to identify affected installations and notify their administrators.
|
|
|
|
|
|
|
|
|
|
## Toggling
|
|
|
|
|
|
2024-11-11 13:12:39 +02:00
|
|
|
You can turn telemetry on or off using either the
|
|
|
|
|
`CODER_TELEMETRY_ENABLE=[true|false]` environment variable or the
|
|
|
|
|
`--telemetry=[true|false]` command-line flag.
|