Files
meshcore-exporter/repeaters.example.toml
T
tthandClaude Opus 5.5 2a9126e258
ci / test (push) Successful in 1m12s
image / build (arm64) (push) Successful in 1m52s
image / build (amd64) (push) Successful in 2m1s
image / release (push) Successful in 9s
meshcore-exporter 1.0.0
Prometheus exporter for MeshCore repeaters, read over the mesh: a companion
(USB, BLE, or a companion identity in openHop over TCP) logs in to each
repeater, asks for status and telemetry with direct packets and serves
battery, temperature/humidity, noise floor, RSSI/SNR, packet counters,
airtime and uptime on :9200/metrics.

- meshcore_exporter.py: command line, MC_* environment or a TOML file with
  a password per repeater; --check reads every repeater once and exits;
  interval 1 h (min 15 min); a failed repeater is retried once after 3 min;
  contacts fetched once per round.
- dashboards/: the Grafana dashboard, generated from generate.py
  (datasource, job and the rate window are variables; TX drawn above zero,
  RX below).
- stack/: Docker Compose with Prometheus and Grafana provisioned, for a USB
  companion, or on the host network for openHop on the same machine.
- systemd/: running without Docker.
- README.md (Czech) and AGENTS.md for setting it up with an AI agent.
- CI: lint and tests, gitleaks; PR check builds the image; single-platform
  images per architecture behind a Trivy gate (latest-<arch>, and X.Y.Z-<arch>
  with a release on tag vX.Y.Z); dependencies by Renovate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 21:52:21 +01:00

25 lines
1015 B
TOML

# Copy to repeaters.toml (git ignores it) and fill in. Top-level keys are the
# defaults of the command-line options; command line and MC_* env win.
# The companion radio -- exactly one of these:
serial = "/dev/serial/by-id/usb-REPLACE_ME-if00" # `ls /dev/serial/by-id/`
# tcp = "192.168.1.50:5000" # WiFi companion
# ble = "AA:BB:CC:DD:EE:FF" # BLE companion
# ble_pin = "123456"
interval = 3600 # seconds between rounds (min 900)
# path_hash_bytes = 2 # Czech mesh: 2
# Default password for the blocks below that have none. Admin or guest:
# a guest gets everything except external sensors (humidity, ambient temp).
password = "REPLACE_ME"
[[repeater]]
name = "my-repeater" # exactly as the repeater advertises itself
# [[repeater]]
# name = "other-repeater"
# password = "its own password"
# pubkey = "64 hex chars" # only if the companion never heard its advert
# path = "5361" # force a route via other repeaters (hex hop hashes)