Skip to content

Installation & Setup

Jump to bottom
Fischer, Fabian edited this page Apr 28, 2026 · 1 revision

Installation & Setup

Prerequisites

  1. A KachelmannWetter Plus subscription — kachelmannwetter.com
  2. An API key — activate it in your account settings under "API-Keys verwalten"
  3. A configured API location — set it under "API-Standorte verwalten" in your subscription (max 2 locations on the hobby plan)

⚠️ The API key and the location must be configured on the Kachelmann website before setting up the integration. The API will return 403 if the coordinates don't match a configured location.

Installation via HACS (recommended)

  1. Open HACS in Home Assistant
  2. Click the three dots menu (top right) → Custom repositories
  3. Add https://github.com/nodomain/haKachelmannWetter with category Integration
  4. Search for "KachelmannWetter" and install it
  5. Restart Home Assistant

Or use the one-click button:

Open HACS Repository

Manual Installation

  1. Download the latest release
  2. Copy the custom_components/kachelmannwetter folder to your HA config/custom_components/ directory
  3. Restart Home Assistant

Configuration

  1. Go to Settings → Devices & Services → Add Integration
  2. Search for KachelmannWetter
  3. Enter your API key and the coordinates of your configured API location
  4. Done — all entities will be created automatically

The config flow pre-fills your Home Assistant home coordinates as defaults.

Options

After setup, you can adjust the update interval via the integration options:

Setting Default Min Max
Update interval 600s (10 min) 60s 3600s

Go to Settings → Devices & Services → KachelmannWetter → Configure to change it.

Updating

  • HACS: Updates appear automatically in the HACS dashboard
  • Manual: Replace the custom_components/kachelmannwetter folder and restart

Breaking changes

Check the Changelog before updating. Breaking changes are marked with ⚠️.

Notable: v2.0.0 changed the device identifier from config entry ID to coordinates — you need to remove and re-add the integration after updating to v2.x.

Reauth

If your API key expires or changes, Home Assistant will show a "Reauth required" notification. Click it and enter your new API key — no need to remove the integration.

Clone this wiki locally