# \[APP\]\[Pro\] Insteon - Control Insteon devices via Insteon Hub 2245/2242
**URL:** https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182
**Category:** Apps
**Tags:** app, tools, homey-pro
**Created:** [February 16, 2026, 8:04am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182 "2026-02-16T08:04:18Z")
**Posts on this page:** 9
**Page:** 1
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [February 16, 2026, 8:04am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/1 "2026-02-16T08:04:18Z")
**Insteon - Community App**
> The Insteon app enables local control/status of Insteon devices, scenes and sensors directly from Homey Pro and Homey Self-Hosted Server
## Requirements
* * *
- **Homey Pro or Homey Self-Hosted Server** with firmware **12.2.0 or higher**
- **Insteon Hub** (model 2245-222 or 2242-222) on your local network
- Hub **username** and **password** (optional for model 2242-222)
- Insteon device IDs (6-character hex, e.g., `45ED1C`)
## Features
* * *
✅ **Fast Direct Control** - Direct HTTP commands to the Insteon 2245-222 hub (~100ms response)
✅ **Test connection** - Verify connection to Insteon hub 🆕
✅ **Hub unreachable error handling** - Optimized error handling to eliminate app crashing 🆕
✅ **Real-time Events** - Bidirectional sync via home-controller library
✅ **Insteon Scene Support** - Control Insteon Scenes from a custom driver or Flows
✅ **Multiple Device Types** - Lights, switches, sensors, and scenes
✅ **Multilingual** - English, Dutch, German, Spanish, French
## Compatible Device Types
* * *
### Actuators
- **Switches** : On/off control of wall switches, wall outlets, plug-in switches, micro switches and I/O Linc
- **Dimmers** : Brightness control for wall dimmer switches, dimmer wall outlet 2472DIV, plug-in dimmers, micro dimmers and Insteon LED lightbulbs
### Sensors
- **Contact Sensors**
- **Motion Sensors**
- **Leak Sensors**
* * *
> **[Insteon | Homey](https://homey.app/en-us/app/com.insteon/Insteon/)**
>
> Control Your Home, Your Way
> **NOTE:** I am not a developer and did not write this code. It has been migrated from earlier work through AI-assisted development (Vibe coded), with Claude Sonnet 4.5 serving as the primary developer. I provided Claude.ai with the scope and requirements, testing and feedback. The results it has delivered are quite good from a functional point of view.
I am highly experienced with smart home platforms and devices, but not with coding. Additionally, I’m fairly new to Homey. I tested this app to the best of my abilities and looked at the generated output, but there could be bugs or patches that wouldn’t make sense to someone who has the skills to do better.
It is not possible for me personally to help with any bugs or feature enhancements without continuing to rely on an LLM.
Review from experienced developers and pull requests are welcome, and would be greatly appreciated as a service to the community.
* * *
[Insteon integration for Homey on GitHub](https://github.com/logname/com.insteon)
* * *
> ## Disclaimer
>
> This app is not officially affiliated with, or endorsed by Insteon or Athom.
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [February 16, 2026, 8:22am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/2 "2026-02-16T08:22:24Z")
# Quick Start Guide - Insteon app
## Prerequisites ✓
- Homey Pro (2023 or later)
- Insteon Hub 2245 or 2242
- Hub IP address
- Hub username and password
- Device IDs for your Insteon devices
## Step 1: Install App
1. Open Homey app
2. Go to **Add** → **New Device**
3. Search “ **Insteon** ”
4. Tap **Install**
5. Wait for completion
## Step 2: Configure Hub
1. Go to **Settings** → **Apps** → **Insteon**
2. Tap **Configure**
3. Enter:
- Hub IP: `192.168.1.55` [Example only - Enter your actual Insteon hub IP address]
- Port: `25105`
- Username: `your_username`
- Password: `your_password`
- Model: `2245` (or 2242)
4. Tap **Test Connection** - The debug log will be temporarily enabled
5. **Verify:** Check logs for “Validation passed” and “WebSocket port OK - ✓ Connection successful!”
6. Tap **Save** only if you the connection validation passed and sucessfully connected to the WebSocket, otherwise you must troubleshoot connection issues before saving (see troubleshooting tips below)
## Step 3: Add Your First Device
### For a Light/Dimmer:
1. **Devices** → **Add Device** → **Insteon for Homey**
2. Select **Insteon Dimmer/Light**
3. Tap **Next** → **Add**
4. Go to device settings:
- Device ID: `45ED1C` (your device’s 6-char ID)
- Dimmable: ✓ (if dimmer) or ✗ (if switch)
- Fast Commands: ✓ (recommended when instant ON is desired)
5. Tap **Save**
### For a Sensor:
Same process, but select the sensor type and only enter Device ID.
## Step 4: Test It!
1. Tap the device in Homey
2. Toggle ON/OFF
3. Verify light responds
4. Press physical button
5. Verify Homey updates
**Success!** Your Insteon device is now controlled by Homey!
## Common Device IDs Format
✓ Correct: `45ED1C`, `A1B2C3`, `FF1234`
✗ Wrong: `45.ED.1C`, `45-ed-1c`, `45 ED 1C`
(Remove periods/dashes, use uppercase)
## Finding Your Hub IP
### Method 1: Router
1. Log into router
2. Look for “Insteon Hub”
3. Note the IP address
### Method 2: Insteon App
1. Open Insteon app
2. Settings → Hub Info
3. Note IP address
## Finding Device IDs
### Physical Device
Look for label with format: `45.ED.1C`
Remove periods: `45ED1C`
### Insteon App
Device → Settings → Device ID
## Troubleshooting
### Hub Not Connecting
**Symptom** : “Not connected to Insteon hub” error
**Solutions** :
1. Verify hub IP address is correct:
```auto
ping 192.168.1.55 [Example only - Enter your actual Insteon hub IP address]
```
2. Check hub is on same network as Homey
3. Verify username/password (try logging into hub web interface)
4. Ensure hub model is correct (2245 vs 2242)
5. Restart the app:
- Settings → Apps → Insteon → Restart App
### Device Not Responding
**Symptom** : Device doesn’t respond to commands
**Solutions** :
1. Verify Device ID is correct (6 characters, no periods)
2. Check device is linked to hub:
- Open Insteon app
- Verify device appears in device list
3. Test device in Insteon app first
4. Verify device has power
5. Try removing and re-adding the device
### Status Not Updating
**Symptom** : Physical device changes don’t update in Homey
**Solutions** :
1. Verify hub connection is active (check app logs)
2. Ensure device is properly linked to hub
3. Check the app debug log and ensure the WebSocket server is running (port 8080)
4. Restart the app
5. For sensors, verify they’re sending events to hub
### Dimming Not Working
**Symptom** : Light turns on/off but won’t dim
**Solutions** :
1. Verify device is actually a dimmer (not just a switch)
2. Check “Dimmable” setting is enabled
3. Test dimming in Insteon app first
4. Some devices may not support dimming
## Advanced Configuration
### Using Fast Commands
Fast commands turn lights on/off instantly without ramping:
1. Go to device settings
2. Enable “Use Fast ON/OFF”
3. Save settings
**Note** : Fast commands may not work with all device types
### WebSocket Port
The WebSocket server (default port 8080) allows external integrations:
1. If WebSocket fails verification, the debug log will show "❌ Connection failed: Hub OK, but Port 8080 is in use.
2. Try port 8081 and tap **Test Connection** again
3. **Verify:** Check logs for “Validation passed” and “WebSocket port OK - ✓ Connection successful!”
4. Tap **Save Settings**
5. Restart the Insteon app
### Scene Support
To control Insteon scenes:
1. Add devices with deviceType “scene”
2. Use the group number as the device ID
3. Scene commands will affect all linked devices
## Network Requirements
- **Firewall** : Ensure ports are open:
- **Static IP** : Recommended to assign static IP to hub:
## Best Practices
1. **Use descriptive names** : “Kitchen Light” vs “Light 1”
2. **Keep firmware updated** : Update hub firmware regularly
3. **Document Device IDs** : Keep a list of device IDs and locations
4. **Test after changes** : Always test after adding/modifying devices
5. **Monitor logs** : Check app logs if issues occur
## Getting Help
If you encounter issues:
1. Check app debug log:
2. Verify hub connection:
3. Verify the WebSocket connection:
4. Test in Insteon app:
5. Report issues:
- GitHub: [Issues · logname/com.insteon · GitHub](https://github.com/logname/com.insteon/issues)
- Include logs and device information
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [February 16, 2026, 8:22am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/3 "2026-02-16T08:22:32Z")
# Important note to all Insteon app users
The websock port defaults to **8080**. This can be found in the Insteon app for Homey under **Configure** \> **Advanced Settings (Websocket Port)**.
## Version 1.8.2 includes the following important changes:
- Previously unhandled asynchronous errors were causing Node.js to crash. The method for catching HTTP operation errors has been changed
- Important bug fixes
- Prior improvements to prevent a crash loop when the default WebSocket port 8080 is unavailable are included
- The **Test Connection** button now tests the WebSocket port in addition to the Hub connection and the debug log includes a suggestion to increment the port to 8081 and retest
Thank you for helping to make the Insteon app better!
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [February 16, 2026, 8:22am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/4 "2026-02-16T08:22:40Z")
Placeholder 3
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [February 16, 2026, 8:22am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/5 "2026-02-16T08:22:48Z")
Placeholder 4
---
### Author:  [@Miguel\_Castro](https://community.homey.app/u/Miguel_Castro)
#### Post date: [April 1, 2026, 8:06pm UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/6 "2026-04-01T20:06:13Z")
Well you and Claude did a great job cause it works like a charm. I do want to ask about this: Bidirectional sync via home-controller library
Is this supposed to mean that manually using an Insteon switch lets Homey know about its new state? If so, I don’t find this to be the case. What do you mean by the home-controller library?
Thsnks
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [April 1, 2026, 9:04pm UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/7 "2026-04-01T21:04:34Z")
Thanks for trying out the app! I’ve tested this extensively with my own system and it works as expected. I do know that you can see the ON/OFF button react in real time when you manually control an Insteon dimmer or switch, but you will not see the dim level change in real time.
When dimming manually at the switch, you will initially see the dim level on Homey show as 1%, but Homey will then update to show the current dim level after a short delay. This is limitation of how the home-controller API works. Changes on Homey will change Insteon devices to the same state, but you will never see an instant update on Homey until a change occurs at the Insteon device.
Regarding Home-Controller:
It is an API that uses the direct PLM connection over TCP. Like Insteon, it’s old but still works.
If you are still not seeing that change, maybe you can help improve the app with some more information. Are you using a 2245 hub or a 2242 hub? Which Insteon device and model number are you testing with?
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [May 26, 2026, 8:53pm UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/9 "2026-05-26T20:53:30Z")
# Important changes and bug fixes. All Insteon app for Homey users should update to prevent crash loops from occurring.
My sincere apology for any inconvenience. I’m uncertain the issue won’t persist, but I’m monitoring closely to try resolve the occasional crashes once and for all.
> [@SmartHomePrimer](#):
>
> # Important note to all Insteon app users
>
> The websock port defaults to **8080**. This can be found in the Insteon app for Homey under **Configure** \> **Advanced Settings (Websocket Port)**.
>
> ## Version 1.8.2 includes the following important changes:
>
> - Previously unhandled asynchronous errors were causing Node.js to crash. The method for catching HTTP operation errors has been changed
>
> - Important bug fixes
>
> - Prior improvements to prevent a crash loop when the default WebSocket port 8080 is unavailable are included
>
> - The **Test Connection** button now tests the WebSocket port in addition to the Hub connection and the debug log includes a suggestion to increment the port to 8081 and retest
---
### Author:  [@SmartHomePrimer](https://community.homey.app/u/SmartHomePrimer)
#### Post date: [June 1, 2026, 12:28am UTC](https://community.homey.app/t/app-pro-insteon-control-insteon-devices-via-insteon-hub-2245-2242/151182/10 "2026-06-01T00:28:04Z")
# I need help from two particular Insteon users please!
Will the users with the Insteon hub IP addresses of 192.168.50.111 and 10.0.1.225 please send me a private message. I’ve been trying for many weeks to work with Claude AI to resolve crashing of the Insteon app for Homey, but have been unsuccessful. I’m in need of detailed information and your two hubs seems to crash frequently. A small number of other users have also experienced a crash, but only 1 for each and several other Insteon app users are not experiencing any crashing.
I’m not able to replicate the issue with my own Insteon hub, so I’d like to kindly ask for your help in determining what it is about your two hubs that are similar.
Here’s the crash count for the Insteon app with each of your hubs:
# **Insteon hub IP 192.168.50.111**
**75** crashes on version 1.8.1
**281** crashes on version 1.8.2
**983** crashes on version 1.8.3
# **Insteon hub IP 10.0.1.225** ← Your particular hub is suffering with this app. Please send a diagnostic report so I can try to resolve whatever is uniquely causing your Insteon setup to crash the app continuously.
**75** crashes on version 1.8.1
**281** crashes on version 1.8.2
**5286** crashes on version 1.8.3