Exporters

BLE Scale Sync exports body composition data to 5 targets. The setup wizard walks you through exporter selection, configuration, and connectivity testing.

Exporters are configured in global_exporters (shared by all users). For multi-user setups with separate accounts, see Per-User Exporters. All enabled exporters run in parallel — the process reports an error only if every exporter fails.

Target	Description
Garmin Connect	Automatic body composition upload — no phone app needed
MQTT	Home Assistant auto-discovery with 10 sensors, LWT
InfluxDB	Time-series database (v2 write API)
Webhook	Any HTTP endpoint — n8n, Make, Zapier, custom APIs
Ntfy	Push notifications to phone/desktop

Garmin Connect

Automatic body composition upload to Garmin Connect — no phone app needed. Uses a Python subprocess with cached authentication tokens.

Field	Required	Default	Description
email	Yes	—	Garmin account email
password	Yes	—	Garmin account password
token_dir	No	~/.garmin_tokens	Directory for cached auth tokens

global_exporters:
  - type: garmin
    email: '${GARMIN_EMAIL}'
    password: '${GARMIN_PASSWORD}'

Authentication

The setup wizard handles Garmin authentication automatically. You only need to authenticate once — tokens are cached in ~/.garmin_tokens/ and reused. To re-authenticate manually:

# Docker
docker run --rm -it -v ./config.yaml:/app/config.yaml \
  ghcr.io/kristianp26/ble-scale-sync:latest setup-garmin

# Native
npm run setup-garmin

IP blocking

Garmin may block requests from cloud/VPN IPs. If authentication fails, try from a different network, then copy ~/.garmin_tokens/ to your target machine.

MQTT

Publishes body composition as JSON to an MQTT broker. Home Assistant auto-discovery is enabled by default — all 10 metrics appear as sensors grouped under a single device, with availability tracking (LWT) and display precision per metric.

Field	Required	Default	Description
broker_url	Yes	—	mqtt://host:1883 or mqtts:// for TLS
topic	No	scale/body-composition	Publish topic
qos	No	1	QoS level (0, 1, or 2)
retain	No	true	Retain last message
username	No	—	Broker auth username
password	No	—	Broker auth password
client_id	No	ble-scale-sync	MQTT client identifier
ha_discovery	No	true	Home Assistant auto-discovery
ha_device_name	No	BLE Scale	Device name in Home Assistant

global_exporters:
  - type: mqtt
    broker_url: 'mqtts://broker.example.com:8883'
    username: myuser
    password: '${MQTT_PASSWORD}'

Webhook

Sends body composition as JSON to any HTTP endpoint. Works with n8n, Make, Zapier, or custom APIs.

Field	Required	Default	Description
url	Yes	—	Target URL
method	No	POST	HTTP method
headers	No	—	Custom headers (YAML object)
timeout	No	10000	Request timeout in ms

global_exporters:
  - type: webhook
    url: 'https://example.com/hook'
    headers:
      X-Api-Key: '${WEBHOOK_API_KEY}'

InfluxDB

Writes metrics to InfluxDB v2 using line protocol. Float fields use 2 decimal places, integer fields use i suffix.

Field	Required	Default	Description
url	Yes	—	InfluxDB server URL
token	Yes	—	API token with write access
org	Yes	—	Organization name
bucket	Yes	—	Destination bucket
measurement	No	body_composition	Measurement name

global_exporters:
  - type: influxdb
    url: 'http://localhost:8086'
    token: '${INFLUXDB_TOKEN}'
    org: my-org
    bucket: my-bucket

Ntfy

Push notifications to phone/desktop via ntfy. Works with ntfy.sh or self-hosted instances.

Field	Required	Default	Description
url	No	https://ntfy.sh	Ntfy server URL
topic	Yes	—	Topic name
title	No	Scale Measurement	Notification title
priority	No	3	Priority (1–5)
token	No	—	Bearer token auth
username	No	—	Basic auth username
password	No	—	Basic auth password

global_exporters:
  - type: ntfy
    topic: my-scale
    priority: 4

Secrets

Use ${ENV_VAR} references in YAML for passwords and tokens. The variable must be defined in the environment or in a .env file:

global_exporters:
  - type: garmin
    email: '${GARMIN_EMAIL}'
    password: '${GARMIN_PASSWORD}'

See Configuration — Environment Variables for details.

Healthchecks

At startup, exporters are tested for connectivity. Failures are logged as warnings but don't block the scan.

Exporter	Method
MQTT	Connect + disconnect
Webhook	HEAD request
InfluxDB	/health endpoint
Ntfy	/v1/health endpoint
Garmin	None (Python subprocess)