Home Assistant 2025.12.0 Compatibility Fix

Release Notes - Version 2.0.1

Home Assistant 2025.12.0 Compatibility Fix

Overview

This release fixes compatibility issues with Home Assistant 2025.12.0, specifically addressing the 500 Internal Server Error that occurred when clicking the Configure button for the integration.

What's Fixed

Configuration Flow Error (500 Internal Server Error)

• Issue: Clicking the Configure button resulted in a 500 error with AttributeError or TypeError in Home Assistant 2025.12.0
• Root Cause: Breaking changes in Home Assistant 2025.12.0's OptionsFlow architecture
  • The config_entry attribute became a read-only property managed by the framework
  • The OptionsFlow base class no longer accepts parameters in its initialization
• Solution: Updated the options flow to comply with the new architecture
  • Removed custom __init__ method from OoklaSpeedtestOptionsFlow
  • Updated async_get_options_flow to instantiate the flow without arguments
  • The framework now automatically injects the config_entry property after instantiation

Changes Made

File Modified: custom_components/ookla_speedtest/config_flow.py

1. Removed custom initializer (Previously lines 147-149)

   # REMOVED:
   def __init__(self, config_entry: config_entries.ConfigEntry) -> None:
       """Initialize options flow."""
       self.config_entry = config_entry

2. Updated flow instantiation (Line 121)

   # Before:
   return OoklaSpeedtestOptionsFlow(config_entry)
   
   # After:
   return OoklaSpeedtestOptionsFlow()

Compatibility

• Home Assistant 2025.12.0: ✅ Fully Compatible
• Home Assistant 2025.11.x and earlier: ⚠️ Not tested, may require previous version
• Recommended: Home Assistant 2025.12.0 or later

Features Retained

All existing functionality remains intact:

• ✅ UI-based configuration and reconfiguration
• ✅ Server selection (closest, from list, or manual ID)
• ✅ Manual and automatic testing modes
• ✅ Configurable scan intervals
• ✅ All sensors (ping, download, upload, jitter, server, ISP)
• ✅ Service integration (ookla_speedtest.run_speedtest)

Upgrade Instructions

1. Via HACS (Recommended):

   • Go to HACS → Integrations
   • Find "Ookla Speedtest"
   • Click "Update"
   • Restart Home Assistant

2. Manual Installation:

   • Download the latest release
   • Replace the contents of custom_components/ookla_speedtest/
   • Restart Home Assistant

3. Verify the Fix:

   • Go to Settings → Devices & Services
   • Find the Ookla Speedtest integration
   • Click the Configure button
   • Configuration dialog should now load without errors

Breaking Changes

None. This is a compatibility fix that maintains all existing functionality.

Known Issues

None at this time.

Credits

• Fixed by: @soulripper13
• Reported by: Community users upgrading to Home Assistant 2025.12.0
• Thanks to all users who reported this issue and helped with testing

Support

If you encounter any issues with this release:

• Report bugs on GitHub
• Include your Home Assistant version and logs with debug enabled

---

Full Changelog: v2.0.0...v2.0.1