Settings¶
The WattWächter Gas has the same settings as the WattWächter Plus plus the section Gas/water meter; the section Advanced belongs to the electricity meter and is not shown.
Most device settings can be changed via three different paths:
- Web interface — Local UI directly on the device, reachable at
http://wattwaechter-XXXXXXXXXXXX.localfrom the same network - Cloud Portal — Remote access via login.wattwächter.de
- REST API — Directly over HTTP, with all technical details and JSON schemas
What does XXXXXXXXXXXX mean?
The twelve X's represent your WattWächter's individual device ID (the last 12 characters of its MAC address, hexadecimal). You can find it e.g. in the Cloud Portal or in the app.
The settings page arranges the sections in four groups. On a computer they are listed in the sidebar on the left, on a smartphone as a list whose entries expand individually:
| Group | Sections |
|---|---|
| Device & meter | Device, Gas/water meter, Tariffs, Time & language |
| Network | Wi-Fi, Access point |
| Integrations | MQTT, Modbus TCP, Cloud connection |
| Security & maintenance | API security, Updates, System |
Remember to save
Changes only take effect once you press Save — on a computer the button sits below the section, on a smartphone at the bottom of the screen; Reset reloads the stored state. While something is unsaved, the bar shows "Unsaved changes" and the browser warns you before leaving the page.
Device¶
| Setting | Description |
|---|---|
| Device name | Free-form name (max. 31 characters) shown for the device in the app and in the Cloud Portal. The local hostname wattwaechter-XXXXXXXXXXXX.local is not affected. |
| Status LED | Turns the status LED on the device on or off |
Status LED¶
The multicolor status LED on the device shows the current connection and error state (see LED status). If you do not need the indicator, you can turn the LED off entirely here.
API keys: device_name, ledEnable — see REST API reference.
Gas/water meter¶
Here you set which meter the device counts and how the counted revolutions become a meter reading. The steps during setup are explained under Setup.
| Setting | Description |
|---|---|
| Medium | Gas or Water. Gas is billed in kWh, water in m³. Each tariff belongs to its medium. Meter reading and history stay as they are when you switch: 150 m³ of gas then appear as 150 m³ of water. If you move the sensor to another meter, reset the device to factory settings first. |
| Current meter reading (m³) | Shows the reading the device is currently counting. During setup, or if it differs from the meter, enter the reading from the meter here — from then on the device counts on from this value. |
| Volume per revolution (m³) | Printed on the meter next to the last number wheel or the pointer dial (e.g. "1 rev = 0.01 m³"). Typically 0.001 (water) or 0.01 (gas), allowed 0.0001 to 1. A change applies to the following revolutions. |
| Calorific value (kWh/m³) | Gas only. From your gas bill, default 11.0 — see Readings. A tariff with its own calorific value and Z-number takes precedence. |
| Z-number | Gas only. From your gas bill ("Zustandszahl"), default 0.95. |
| Sensitivity (µT) or minimum amplitude | Magnetic Field variant: minimum field change that counts (default 250). Inductive variant: minimum deflection of the coil value (default 15). See Adjusting sensitivity or minimum amplitude. |
API keys: object gw with medium, initialReading, pulseVolume, calorificValue, zNumber, hysteresis — see REST API reference.
Tariffs¶
From firmware 1.3.0. Here you enter the prices the WattWächter uses to calculate costs — for the dashboard, the app and Home Assistant. With the cloud connection enabled, the device keeps its tariffs in sync with the app and the portal, so you can manage them in any of the three places.
| Field | Description |
|---|---|
| Energy price | In ct/kWh |
| Base price | In €/month or optionally €/year. Prorated to the day |
| Calorific value / Z-number | Printed on the gas bill; prefilled from the device settings |
| Valid from / until | Period of the tariff; "until" empty = open-ended |
| Tariff name / provider | Optional, for display only |
Prices change? Don't overwrite the old tariff — add a new one starting on the effective date: from its "valid from" it replaces the previous one, and costs before stay correct. The list marks today's tariff as active and past ones as expired. Up to 15 tariffs per device.
Tariff and medium: every tariff belongs to its medium. After switching gas ↔ water only the tariffs of the new medium count; the previous ones are kept, shown greyed out as "belongs to gas" / "belongs to water", and apply again after switching back.
Time & language¶
| Setting | Description |
|---|---|
| Time zone | Chosen from the device's time zone list (default: Europe/Berlin). Determines all local times — timestamps of the history data, day and month boundaries of the statistics, the time of the nightly update check. Daylight saving time is handled automatically. |
| Language | Deutsch or English (default: German). Affects the texts the device itself generates: the labels of the readings in the API (e.g. "Active energy import" instead of "Wirkenergie Bezug") and in the entity names of the Home Assistant auto-discovery via MQTT, as well as system texts such as the uptime. The web interface appears in this language too; after you save a new language it reloads in that language. |
| NTP server | Time server for the device clock (default: pool.ntp.org). If it is unreachable, the device automatically falls back to built-in backup servers (time.nist.gov, time.google.com). On a company network without internet access, enter your internal time server here. |
Language and MQTT discovery
The entity names for Home Assistant are published when the device connects to the broker. After a language change the new names apply from the next MQTT connection (restart or reconnect); entities that already exist in Home Assistant keep the name they were given.
API keys: timezone, ntp_server, language.active; the time zone list is served by GET /api/v1/system/timezones — see REST API reference.
Wi-Fi¶
Connection to your home network. The WattWächter automatically connects to the stored WiFi on every boot. The badge next to the heading shows whether the connection is currently up.
There are two WiFi profiles: the primary WiFi and an optional secondary WiFi. On boot the device tries the primary network first and only falls back to the secondary one if the primary is not reachable — handy for a second network at the same site or when moving the device.
Per profile:
| Setting | Description |
|---|---|
| SSID | Name of the WiFi network (2.4 GHz) |
| Password | WiFi password (WPA2), max. 63 bytes. Leave empty to keep the stored password. A counter below the field shows the length and warns about leading or trailing whitespace — a typical artefact of pasting from mail or a password manager. |
| Static IP address | Bypasses DHCP. Only use it if your router does not hand out a reliable IP. The toggle reveals the fields IP address, Subnet mask, Gateway and DNS server (empty = the gateway is used as DNS). IP, subnet and gateway are mandatory; invalid entries are rejected on save. |
Changing the SSID without a new password
If you change the SSID but leave the password empty, saving asks for confirmation: the previously stored password is then reused for the new network. That only makes sense for fixing a typo in the SSID — a different network usually needs a different password.
Fixed IP address
If other systems reach the WattWächter by its IP address — e.g. Loxone, a PLC via Modbus TCP or a script — that address should never change. The easiest way is a DHCP reservation in your router: the router then always hands the WattWächter the same IP. The static IP address above is only needed if your router cannot do that. How to find the current IP is described in the FAQ.
API keys: wifi.primary, wifi.secondary (each with ssid, password, static_ip, ip, subnet, gateway, dns) — see REST API reference.
Access point¶
The device can open its own WiFi network — for setup, or when no home WiFi is available.
Without any configuration the access point behaves like this:
- If no WiFi is configured (factory state, after a factory reset), the access point is always on.
- After a cold start (power applied) it runs alongside the home WiFi for 15 minutes and shuts down if nobody connects during that time. It does not start after a software restart (e.g. the nightly update check).
| Setting | Description |
|---|---|
| Enable access point | Keeps the access point on permanently — it no longer shuts down due to inactivity |
| SSID | Name of the network. Leave empty for the automatic name WattWaechter-GW-XXXXXX (X = last six characters of the MAC address) |
| Password protection | Secures the access point with WPA2. Without it, the network is open. |
| Password | At least 8 characters. If you enable password protection without entering a password, the web interface asks for confirmation — otherwise the access point starts unprotected. |
IP address on the access point network
On the access point's network the web interface is reachable at http://192.168.4.1 — see Setup.
API keys: accessPoint.enable, accessPoint.ssid, accessPoint.password_enable, accessPoint.password — see REST API reference.
MQTT¶
Sends telemetry data to an MQTT broker — for example to integrate with Home Assistant, ioBroker or other smart home systems. Disabled by default.
→ All fields (broker, port, TLS, user/password, topic prefix, publish interval, CA certificate), topic structure, payload format and Home Assistant auto-discovery are documented under Interfaces → MQTT.
Modbus TCP¶
Exposes the current readings as a Modbus TCP server with its own register block from address 41000 — e.g. for Loxone, openHAB, evcc or other home automation. Disabled by default.
| Setting | Description |
|---|---|
| Enable Modbus TCP server | Starts the server; it listens on the configured TCP port and serves the registers of the gas/water block |
| Port | Default 502 — only change it if that port is already taken |
→ Register map, data types, scale factors and example access are documented under Interfaces → Modbus TCP.
Its own register block instead of SunSpec
The WattWächter Gas does not provide SunSpec but its own register block from address 41000 — see Modbus TCP → Gas and water. Once the server is running, this section lists the registers with their current values.
Switch devices¶
Turns a Shelly or another device with an HTTP interface on or off — by readings, time of day or run time. For example a warning light when unusually much gas flows. In the sidebar the section is called Switching. From firmware 1.3.
With Add rule you create up to four rules. Each rule has:
| Setting | Description |
|---|---|
| Name | Free text, e.g. "Warning light" |
| Device | Shelly (with Output 1–4 and IP address or name of the Shelly), Tasmota (with Output 1–8 and IP address or name of the Tasmota device) or Other device (custom URL) (one URL to switch on and one to switch off, http:// only) |
| Switch on when / Switch off when | Up to four conditions each, combined with all or any |
The conditions to choose from:
| Condition | Meaning |
|---|---|
| Reading | Gas flow above or below a value, optionally for at least N seconds, or Gas without a break — it counts as long as gas is used without interruption and then starts again at 0 |
| Time | At, before or after a time of day, optionally only on certain weekdays |
| Time window | Between two times of day, optionally only on certain weekdays |
| Duration | Device on or off for at least N minutes |
| Amount | This much gas has flowed since switching on or off |
Switching happens as soon as "Switch on" or "Switch off" is newly met; if both hold at once, the device is switched off. If you then switch by hand, it stays that way until one side occurs again. After saving, each rule shows the device's state; Switch on, Switch off and Check connection let you test it by hand.
Missed time of day
A condition such as "at 06:00" holds only during that one minute. If the WattWächter misses it, it catches up on the switching for up to 15 minutes: if the device does not answer, it tries again every 30 seconds. If it was without Wi-Fi itself for a moment, it switches as soon as it is connected again — unless the device has been switched in the meantime. After 15 minutes the switch time lapses until the next time. After a power failure nothing is caught up.
Shelly and Tasmota with a password
Password-protected Shellys and Tasmota devices are not supported yet.
→ API fields and examples: REST API → Switching devices
Cloud connection¶
Here you connect the WattWächter to your WattWächter account, see the connection status and disconnect it again. The cloud is required for app access away from home, the Cloud Portal and remote diagnostics by support. Without it, the device works purely locally — web interface, REST API, MQTT and Modbus keep working.
The Cloud connection entry on the start page leads straight here and also shows the current status.
Status. The top line shows whether the device belongs to an account and is currently connected: connected to the WattWächter cloud, paired, currently not connected (e.g. no internet), paired, transfer paused or not connected to an account. If the cloud rejected a pairing, the reason is shown.
Connect to your account. Paste the pairing token (format WW-XXXXXXXX) from the app or the Cloud Portal and click Start pairing. The page waits for the cloud to confirm and reports either Connected! or why the pairing was rejected (e.g. an expired token). If the device is already paired, the field reads Connect to a different account — the previous assignment is then replaced.
Disconnect. Removes the device from your account; it then stops sending data to the cloud. As in the app, you choose what happens to your data in the cloud:
| Option | Effect |
|---|---|
| Disconnect only | The device disappears from your account; your history in the cloud is kept. |
| Disconnect and delete cloud data | Also deletes this device's history in the cloud, and its name and address in the account. Cannot be undone. |
In both cases, readings, history, tariffs and settings stay on the device. To connect again, you need a new pairing token.
Device currently offline
If the device is not connected to the cloud when you disconnect, "Disconnect only" only takes effect on the device — your account keeps listing it until you remove it in the app or the portal. Cloud data can only be deleted while the device is connected; otherwise the option is greyed out.
All ways to remove a device from your account (including app, portal and REST API): Removing the device.
| Setting | Description |
|---|---|
| Data transfer to the cloud | Switching it off pauses the transfer without unpairing. Takes effect on Save. API key: awsIotEnabled — see REST API reference. |
API security¶
By default, the local REST API is reachable without a token to keep initial setup as simple as possible. On shared networks, we recommend enabling token-based authentication.
Independently of this, from firmware 1.3 on other web pages cannot change anything on the device from the browser unless they know the WRITE token. Details: Writing from other web pages.
| Setting | Description |
|---|---|
| API authentication required | Without a valid token, no API access is possible — this also applies to the web interface and the app on the local network, which then need the token. The settings page then asks for the WRITE token once and remembers it in this browser. |
| Regenerate tokens… | Creates new READ and WRITE tokens and shows them for copying. Only Apply (within 60 seconds) activates them and invalidates the previous ones; with Discard or after the timeout the previous tokens stay valid. Afterwards enter the new tokens wherever the local API is used (app, Home Assistant, Loxone, scripts). Technical details: Authentication. |
When enabled, there are two token levels:
- READ token — Read data (history, status, view settings)
- WRITE token — Change settings, start OTA updates, trigger reboot
Tokens are renewed via a two-phase process to prevent accidental lockout.
Recommendation
Enable authentication when the device is operated on a shared network or the REST API could be reachable by third parties.
API keys: api_auth_required (activation), /api/v1/auth/tokens/* (token rotation) — see REST API reference.
Updates¶
The WattWächter checks for new firmware versions every night.
| Setting | Description |
|---|---|
| Installed / Newest version | The running firmware and the newest version on the update server, plus when it was last checked. If an update is available, its date and changes ("What's new") are shown. |
| Check for updates | Asks the update server right away instead of waiting for the nightly check. |
| Update to x.y.z | Only shown when an update is available. After confirming, the device downloads the new firmware; the page shows the progress and reports when the device answers with the new version. The process takes 2–3 minutes; the device restarts several times and does not measure meanwhile. A running update cannot be cancelled. |
| Install updates automatically | With the toggle on (default), an available update is installed right away during the nightly check. Switched off, the device only reports available updates; you start the installation yourself. |
→ Update flow and troubleshooting: Updates.
API keys: autoOta; GET /api/v1/ota/check (?refresh=1 asks the server now), POST /api/v1/ota/start — see REST API reference.
System¶
| Action | Description |
|---|---|
| Restart | Restarts the device after confirmation. Settings and history data are preserved; the device is unreachable for about half a minute. A software restart does not open the access point — that needs a cold start or the toggle under Access point. |
A factory reset is not available from the web interface — see Factory reset.
API key: POST /api/v1/system/reboot — see REST API reference.



