Migrating Miele HACS to HA-Core

Home Assistant now includes a built‑in Miele integration that connects your appliances via the official Miele API. The old HACS custom component is no longer maintained and should be fully removed before switching to the core integration.

Official Documentation (English)
🔗 Home Assistant Miele integration docs: https://www.home-assistant.io/integrations/miele/

Some days ago, the Miele HACS integration I was using stopped working and was automatically removed after a Home Assistant Update. It took me a while to figure out the pitfalls and how to properly migrate to the official integration. Here’s a concise guide in the hope it helps others.

Backup Your System

Before making changes, create a full snapshot of Home Assistant (Supervisor → Backups) or a Snapshot of your HA-Machine. This lets you roll back if anything goes wrong.

Step‑by‑Step Migration

  1. Reinstall HACS Miele Integration (Temporary)
    • If the old hub cannot be removed under Devices & Services → Integrations → Miele, reinstall the latest HACS Miele integration.
    • Restart Home Assistant.
  2. Remove the Old Miele Hub
    • After restart, go to Devices & Services → Integrations → Miele.
    • Click the three dots and choose Delete.
    • When prompted to delete credentials, confirm – they are no longer needed.
  3. Uninstall HACS Miele Integration
    • Go to HACS and uninstall the Miele component.
    • Restart Home Assistant again.
  4. Add the Official Miele Integration
    • Go to Devices & Services → Add Integration → Miele.
    • Follow the web authentication flow:
      • Sign in with your Miele account (usually your email address) and password.
      • Select your country.
    • After authentication, the integration wizard will display your devices and areas. Confirm to finish setup.
  5. Verify Devices and Automations
    • All devices should now appear correctly.
    • Automations and dashboards may need minor updates if entity IDs changed.

Tips & Pitfalls

  • Web filters can interfere: Brave, AdGuard, Pi‑Hole, etc., can block authentication. Temporarily disable them if login fails.
  • Device power state matters: Some users report that at least one appliance must be switched on for discovery to work.

Thanks to the developer for this excellent work. It adds real value to Home Assistant users.

Related Posts