Skip to content

docs(analytics): describe the daily projectbluefin-countme ping #1355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
castrojo merged 1 commit into from
Sep 29, 2026
Merged

docs(analytics): describe the daily projectbluefin-countme ping #1355

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 16 additions & 7 deletions docs/analytics.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,20 +27,29 @@ Every Project Bluefin count comes from `countme.projectbluefin.io`

### First-party Countme Service & Privacy Guarantees

Project Bluefin images participate in direct weekly countme reporting via systemd services targeting
`https://countme.projectbluefin.io/metalink`.

- **Cohort measurement:** Uses installation age buckets (1: first week, 2: 2–4 weeks, 3: 5–24 weeks, 4: >24 weeks) calculated locally from an installation epoch timestamp.
- **Privacy guarantees:** Transmits only image name, tag, flavor, architecture, and age bucket. No machine ID, IP address, username, or persistent identifier is sent or logged.
Project Bluefin Dakota and Utah images send a daily active-system ping from the
`projectbluefin-countme` systemd timer to `https://countme.projectbluefin.io/v1/ping`.
Other images do not send it.

- **What is sent:** a single string, `<image-name>/<image-flavor>:<stream>`, where the stream
is the booted image's tag (`stable`, `testing`, or `unknown`). Nothing else: no install age,
architecture, machine ID, username, or persistent identifier.
- **How often:** at most once per day per system, and never from a live ISO, installer, or
container.
- **What is stored:** one counter per UTC day and image. No per-system rows and no IP addresses.
A day's count is the number of systems active that day, not distinct devices over time.

### Opt-Out Instructions

To stop Project Bluefin countme reporting now and across reboots, mask its systemd timer and service:
To stop Project Bluefin countme reporting now and across reboots, mask its systemd timer:

```bash
sudo systemctl mask --now bluefin-countme.timer bluefin-countme.service
sudo systemctl mask --now projectbluefin-countme.timer
```

A mask of the previous `bluefin-countme.timer` or `bluefin-countme.service` units, and the
`/etc/projectbluefin/countme/disabled` opt-out file, still stop reporting.

To disable upstream Fedora countme:

- [Fedora countme documentation](https://coreos.github.io/rpm-ostree/countme/)
Expand Down
Loading