Skip to content

Commit a7a32a3

Browse files
committed
content: usage: add data privacy section
1 parent 55122f3 commit a7a32a3

2 files changed

Lines changed: 51 additions & 0 deletions

File tree

content/usage/advanced/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1024,6 +1024,7 @@ These features help with error tracking and troubleshooting, so in normal use ca
10241024
a different device running Cockpit
10251025
- **Usage statistics telemetry** can be automatically sent to the Cockpit development team to help identify and
10261026
track common errors and performance issues across global Cockpit usage
1027+
- See the [Data Privacy](../privacy) page for more details
10271028
- **System logging** creates [application logs](#system-application-logs) that can be checked or shared with
10281029
developers to help debug issues
10291030
- If system logs are disabled then messages are sent to the browser/application console instead, which may

content/usage/privacy/index.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
+++
2+
title = "Data Privacy"
3+
description = "Cockpit data collection and usage documentation."
4+
date = 2025-07-12T05:50:00+08:00
5+
template = "docs/page.html"
6+
sort_by = "weight"
7+
weight = 40
8+
draft = false
9+
10+
[extra]
11+
lead = ''
12+
toc = true
13+
top = false
14+
+++
15+
16+
## Context
17+
18+
Any device which connects to the internet provides some information about itself and its user in doing so. How that information is processed, stored, and used determine whether it is a potential privacy concern.
19+
20+
As open source software, Cockpit can be freely independently reviewed and audited for privacy risks, and we encourage users to educate themselves on what data is exposed through connecting your vehicle to the internet and making use of the services within Cockpit.
21+
22+
## Intent
23+
24+
1. Anonymous usage data and statistics are collected to inform the development direction, identify problems within Cockpit, and share insights with the community
25+
1. No data is collected for or sold to advertisers
26+
27+
## Data Collection and Usage Details
28+
29+
### Automatic Events
30+
31+
| Service | Domain | Data | Usage |
32+
| --- | --- | --- | --- |
33+
| [Error statistics and tracebacks](https://github.com/bluerobotics/cockpit/blob/master/src/main.ts) | sentry.io | - IP address<br>- Cockpit version<br>- Error tracebacks | - tracking error rates and reasons<br>- estimating proportions of in-use Cockpit versions<br>- samples removed after 90 days<br>- collection limited to tagged releases of Cockpit (e.g. not development branches) |
34+
| [Usage events and statistics](https://github.com/search?q=repo%3Abluerobotics%2Fcockpit+eventTracker.capture&type=code) | posthog.com | - IP address<br>- Application on-time<br>- Time spent armed<br>- Video recording durations | - tracking feature usage amounts<br>- collection limited to tagged releases of Cockpit (e.g. not development branches) |
35+
36+
### User-Generated Events
37+
38+
None at this time.
39+
40+
## Privacy Protections
41+
42+
Anonymous usage data can provide valuable development insights and improvements with minimal risk or negative impact to individual users. That said, Cockpit does not require an internet connection for its basic operating features, so if you wish to avoid or obscure usage data being sent from your vehicle, you can:
43+
44+
1. Use a VPN service to mask your IP address, and present your vehicle as operating from somewhere else in the world
45+
- These services often cost money, and may slow down updates and Extension installations by reducing your network bandwidth
46+
1. Disable [usage statistics and telemetry](../advanced/#development-troubleshooting)
47+
1. Set up rules in your firewall and/or router to block access to specific domains
48+
- This will prevent using related services on connected devices, although it is generally possible to use an offline workaround
49+
1. Completely avoid connecting your device to the internet
50+
- This will prevent access to all online services, so updates and installations would need to be performed manually or avoided

0 commit comments

Comments
 (0)