Skip to content
Fischer, Fabian edited this page Apr 28, 2026 · 1 revision

FAQ

General

What subscription do I need?

You need a KachelmannWetter Plus subscription. The free tier does not include API access.

How many locations can I monitor?

The hobby plan supports 2 API locations. You can add the integration multiple times in HA with different coordinates (as long as each is configured on kachelmannwetter.com).

Does this work with the free API?

No. The Kachelmann API requires a paid subscription. There is no free tier with API access.

Is this an official integration?

No, this is a custom component maintained by the community. It is not affiliated with Meteologix AG or Kachelmann Gruppe.

Data & Updates

How often does the data update?

Default: every 10 minutes. Configurable between 1 and 60 minutes via integration options.

Why is the forecast only 10 days, not 14?

The daily forecast (from the 6h endpoint) covers ~10 days. The 14-day trend is a separate dataset with less detail (no hourly breakdown) but covers 14 days. Both are available — the trend data is in the sensor.kachelmannwetter_trend_14day sensor attributes.

What's the difference between precipitation probability and rain expected?

  • precipitation_probability_today (sensor): Percentage chance of ≥1mm rain today, from the 14-day trend
  • rain_expected_3h (binary sensor): Whether any of the next 3 hourly forecasts show precipitation or rain conditions

Why do I see "clear-night" instead of "sunny"?

The integration automatically switches to clear-night when the API reports isDay = false. This gives you proper nighttime icons in the weather card.

Can I access individual days from the 14-day trend?

Yes! Use the sensor.kachelmannwetter_trend_14day sensor attributes:

{# Today #}
{{ state_attr('sensor.kachelmannwetter_trend_14day', 'days')[0].temp_max }}

{# Day after tomorrow #}
{{ state_attr('sensor.kachelmannwetter_trend_14day', 'days')[2].precipitation_probability_1mm }}

{# Available fields per day: #}
{# temp_max, temp_min, precipitation, precipitation_probability_1mm, #}
{# precipitation_probability_10mm, precipitation_type, wind_gust, #}
{# sun_hours, sun_hours_relative, sun_max_possible, thunderstorm, #}
{# cloud_coverage_eighths, condition, weekday, is_weekend #}

Entities

Why are some sensors disabled by default?

Sensors that most users don't need are disabled to keep the UI clean:

  • Nautical dawn/dusk
  • Astronomical dawn/dusk
  • API requests remaining (diagnostic)

You can enable them anytime from the device page.

Can I change the entity names?

Yes, like any HA entity: click the entity → gear icon → change name. The entity ID stays the same.

What units are used?

All values use metric units:

  • Temperature: °C
  • Wind: km/h
  • Precipitation: mm
  • Pressure: hPa
  • Radiation: W/m² (current) or Wh/m² (daily sum)

HA will convert to your preferred unit system automatically.

Integration Behavior

What happens when the API is down?

The integration raises UpdateFailed, entities show as "unavailable", and HA retries at the next update interval. No manual intervention needed.

What happens when I hit the rate limit?

The integration reads the Retry-After header and schedules an automatic retry. See API & Rate Limits for details.

Does it work behind a proxy?

Yes, it uses Home Assistant's built-in aiohttp session which respects your HA proxy configuration.

Can I use this alongside the built-in weather integrations?

Absolutely. You can have multiple weather entities from different providers. Just use the correct entity ID in your automations and cards.

HACS

The integration doesn't show up in HACS

Make sure you added it as a custom repository first:

  1. HACS → three dots → Custom repositories
  2. URL: https://github.com/nodomain/haKachelmannWetter
  3. Category: Integration

How do I update?

HACS shows available updates in its dashboard. Click update, then restart HA.

Privacy

What data is sent to the API?

Only your configured coordinates (latitude/longitude) are sent with each request. The API key is sent as an HTTP header.

Is my location logged?

Since v2.3.1, coordinates are not written to Home Assistant logs, even at debug level. Only the endpoint type (e.g., "current", "forecast") is logged.

Clone this wiki locally