- Go 75.3%
- JavaScript 13.2%
- CSS 5.6%
- HTML 4.9%
- Shell 1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .forgejo/workflows | ||
| .github | ||
| .woodpecker | ||
| cmd | ||
| db/migrations | ||
| hack | ||
| internal | ||
| scripts | ||
| .dockerignore | ||
| .gitignore | ||
| .releaserc.json | ||
| Dockerfile.dashboard | ||
| Dockerfile.measurement | ||
| go.mod | ||
| go.sum | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| SECURITY.md | ||
Netzbremse
Self-hosted speed telemetry for netzbremse.de, backed by PostgreSQL.
About Netzbremse
Netzbremse ("net brake") is a campaign by AKVorrat.at investigating throttling and net-neutrality violations by Deutsche Telekom and other European ISPs. The project collects crowd-sourced speed-test data via a Cloudflare-backed browser measurement to build an evidence base for regulatory complaints.
This repository provides two service components that run the Netzbremse measurement on a schedule and present the results through a lightweight dashboard:
| Component | Description |
|---|---|
| measurement | Headless browser worker that runs the Netzbremse speed test and writes results to PostgreSQL |
| dashboard | Static web UI and JSON API serving measurement data from PostgreSQL |
Repository layout
cmd/measurement/ Measurement worker entrypoint
cmd/dashboard/ Dashboard server entrypoint
cmd/dashboard/static/ Embedded HTML, CSS, and JS served by the dashboard
internal/ Shared application code (config, model, postgres)
scripts/ Puppeteer-based browser runner
db/ SQL schema
.woodpecker/ CI and release pipelines
Configuration
Database
| Variable | Description |
|---|---|
NETZBREMSE_DATABASE_URL |
PostgreSQL connection URI (preferred) |
DATABASE_URL |
Fallback if the above is not set |
Measurement
| Variable | Description |
|---|---|
NETZBREMSE_MEASUREMENT_INTERVAL |
Time between runs (e.g. 1h) |
NETZBREMSE_ENDPOINT |
Target URL (default: https://netzbremse.de/speed) |
NETZBREMSE_SPEEDTEST_COMMAND |
Override the browser runner command |
NETZBREMSE_SPEEDTEST_TIMEOUT |
Per-run timeout (e.g. 4m) |
NETZBREMSE_IMPORT_DIR |
Directory to watch for legacy JSON result files |
Dashboard
| Variable | Description |
|---|---|
NETZBREMSE_DASHBOARD_LIMIT |
Max rows returned by the measurements API |
Local verification
go test ./...
node --check scripts/netzbremse-browser.mjs
docker build -f Dockerfile.measurement .
docker build -f Dockerfile.dashboard .
CI and release
https://git.m0sh1.cc/m0sh1/netzbremse is the source-of-truth repository.
GitHub is a push mirror for GHCR and GitHub-side automation. Pushes to main
run tests and semantic-release against Forgejo. The release step needs
Woodpecker secrets forgejo_username and forgejo_token with permission to
push tags to the Forgejo repository; Woodpecker's clone-only netrc credentials
are not available inside the Node release image. Tags (v*) trigger the full
release pipeline:
- Build release images for
linux/amd64 - Push to
ghcr.io/isityael/netzbremse-{measurement,dashboard} - Trivy scan, Cosign sign, SPDX SBOM + vuln attestations
- Mirror to
harbor.m0sh1.cc/apps/with Cosign + Notation signatures - GitHub Actions generate CodeQL analysis and build provenance attestations
For the live GitOps deployment, ghcr.io is the source of truth. Harbor keeps a
signed replica for storage and downstream reuse, but the cluster should consume
ghcr.io/isityael/netzbremse-* images.
Licence
This project builds on the open measurement infrastructure published by AKVorrat. The PostgreSQL backend, dashboard, and CI pipeline are original work for m0sh1.cc.