Support

Something not working, or a measurement missing? Write to [email protected] — include your iOS version and your Home Assistant version and it will be easier to help.

What you need

  • An iPhone on iOS 18 or later.
  • A Home Assistant instance you can reach from the phone, with a body scale whose readings arrive as entities.
  • Permission for the app to write to Apple Health.

Getting started

  1. 01 Enter the address of your Home Assistant instance — a local one like http://homeassistant.local:8123 works, as does a public HTTPS one.
  2. 02 Sign in through Home Assistant, or paste a long-lived access token instead.
  3. 03 Confirm which entity is your weight, and any body-composition entities your scale reports.
  4. 04 Allow the Health permission when iOS asks, then tap Sync.

Common questions

The app cannot reach my Home Assistant

If the address is a local one, iOS asks for local-network permission the first time — and if it was declined, the request fails with no visible reason. Turn it back on in Settings → Body Scale Sync → Local Network. Otherwise check that the address opens in Safari on the same phone, over the same Wi-Fi.

Nothing appears in Health

Health permissions are per measurement, and iOS asks only once. Open Settings → Health → Data Access & Devices → Body Scale Sync and check that writing is allowed for each measurement you expect. Read access matters too — it is how the app avoids writing the same reading twice.

Background sync does not run as often as I set

iOS decides when a background refresh actually runs, based on how often you open the app; the interval in Settings is a floor, not a schedule. A newly installed app may go a day or two before iOS starts running it regularly. The Sync button runs exactly the same code, so nothing is lost by using it.

I deleted a reading and it came back

It should not — the value is still in Home Assistant, so the app records that you deleted it and never carries that reading again. If it did reappear, that is a bug worth an email.

An old reading never arrived

The app reads the current state of your entities and what the Home Assistant recorder still holds. A reading taken during a period the recorder has since purged is no longer available to read.

Bug reports, questions and feature requests all go to [email protected].