Troubleshooting
These diagnostic tools solve the vast majority of HomeKitLink Siri issues.
Run them before anything else, and before posting on the forum.
Plugins → HomeKitLink Siri → ℹ️ Troubleshoot 1 Support Information For Forum Posting
Captures your complete HKLS configuration, bridge status, device publication list, and network settings. Copy this output and include it in every forum support post.
Plugins → HomeKitLink Siri → ℹ️ Troubleshoot 2 Network Trouble Shooting
Performs a comprehensive network diagnostic — Local Network Access, multicast, firewall, bridge ports, DNS. The output tells you exactly what is and isn't working.
Plugins → HomeKitLink Siri → ℹ️ Troubleshoot 3 Support mDNS Troubleshooting
Checks mDNS/Bonjour health — whether bridges are advertising correctly, interface binding, Bonjour service status. Essential for "bridge not visible" problems.
See Plugin Menu Items for full details on what each tool checks.
This is the most common issue. Work through these steps in order:
The output will identify the problem in most cases.
- Is the Mac running Indigo on the same Wi-Fi network as the iPhone?
- Is the Mac accessible and not behind a firewall?
- Try adding the bridge from a different iOS device — if it works there, the issue is with that specific iPhone
macOS Sequoia (15.x+) requires Local Network Access permission for mDNS to work:
- Open System Settings → Privacy & Security → Local Network
- Enable the toggle for IndigoPluginHost3
- Also enable Indigo (the server app) if listed
- If neither appears: restart the HKLS plugin — macOS will prompt for permission
Troubleshoot 2 performs a definitive multicast send test that confirms whether LNA is blocked. Look for:
✅ Successfully sent multicast packet to 224.0.0.251:5353 — Local Network Access is ENABLED.vs.
❌ Failed to send multicast packet — Local Network Access may be BLOCKED.
HomeKit encryption state can sometimes get corrupted. If the bridge previously worked but stopped being discoverable:
- Remove the bridge from the Home app
- Run Plugins → HomeKitLink Siri → Reset Accessory / Bridge
- Restart the plugin
- Re-add with the QR code
On your iPhone:
- Settings → Wi-Fi → your network → Forget This Network
- Reconnect to the Wi-Fi
- Try adding the bridge again
A bridge with no published devices running successfully confirms the issue is network/discovery, not a device configuration problem. Try:
- Remove all devices from a bridge (uncheck Publish, Save each)
- Save the dialog — restart the bridge
- Try to see the empty bridge in the Home app
If the empty bridge is visible, the problem is with a specific device configuration.
Cause: A device was changed from one HomeKit type to another without following the correct procedure.
Fix:
- Uncheck Publish for the problem device → Save Device
- Save the dialog (restart the bridge)
- Confirm the old device type has disappeared in the Home app
- Re-add the device with the new type
See Setup & Configuration — Changing a Device's HomeKit Type for the full procedure.
Cause: The Indigo device state being used contains a type the sensor doesn't expect.
Common example: Temperature sensor state contains "22.1°C" (string with units) instead of 22.1 (plain number).
Fix:
- Open the bridge config, select the device
- Check which state is mapped — the config shows the current value
- Select a different state that contains a plain number
- If no suitable state exists, the device may need to be pre-processed (e.g. via an Indigo variable and virtual device)
Cause: The bridge was added to the Home app and then something changed the bridge's security keys without re-pairing.
Fix:
- Delete the bridge from the Home app first
- Plugins → HomeKitLink Siri → Reset Accessory / Bridge — select the bridge
- Run Plugins → HomeKitLink Siri → Restart HomeKit
- Re-add via QR code
If the plugin log shows pip install errors at startup:
- Check the Indigo log for the specific package that failed
- Try Plugins → HomeKitLink Siri → Restart HomeKit
- Check macOS has network access (pip downloads from PyPI)
- If a specific package repeatedly fails, post on the forum with the full error output
- Troubleshoot 3 — built-in mDNS diagnostic
- Discovery - DNS-SD Browser (macOS) — see mDNS advertisements on your network
- RouteThis — network diagnostic tool
See Advanced Configuration for interface binding, IP version selection, and AWDL settings.
See the Camera Setup troubleshooting section: Camera Setup — Common Camera Issues
If Show Device Publications shows devices in red (bridge deleted):
Plugins → HomeKitLink Siri → Unlink any Orphaned Devices
This clears the bridge reference so the devices can be re-published to a new bridge.
The HomeKitLink Siri forum is the best place for support. To get the fastest help:
- ✅ Run all three Troubleshoot menu items
- ✅ Copy the complete Indigo log output from each tool
- ✅ Describe what you expected vs. what happened
- ✅ Include your Indigo version, macOS version, and plugin version
- ❌ Don't post partial logs — include everything from the troubleshoot tools
The troubleshoot tools give forum helpers everything they need. Without this output, diagnosing your issue is much harder and slower.
→ Advanced Configuration — mDNS, networking, debug deep-dive
Getting Started
Features
Reference
Support
Before posting:
Run menu items
1, 2 & 3 ❗