Installation
Home Assistant Installation
Install TOMMY as a Home Assistant App, integrating with your Home Assistant instance.
Requirements
- Home Assistant OS
- AMD64 or ARM64 architecture
Installation Steps
Add the TOMMY Repository
Click the button below to add the TOMMY repository to your Home Assistant instance:
Add repository to Home AssistantOr manually add the repository:
- Navigate to Settings → Apps → App Store
- Click the three dots menu (⋮) in the top right
- Select Repositories
- Add this URL:
https://github.com/tommy-sense/homeassistant-addon
Install the TOMMY App
- Refresh the App Store page
- Find "TOMMY" in the list of available apps
- Click on the TOMMY app
- Click Install
Configure the App
After installation, configure ports if needed:
- Go to the Configuration tab
- Adjust ports if they conflict with your setup:
| Port | Default | Purpose |
|---|---|---|
dashboard | 8089 | Web dashboard |
file_server_http | 8090 | Configuration file and OTA |
file_server_https | 8091 | Configuration file and OTA |
mqtt | 1886 | Built-in MQTT broker |
udp_relay | 8547 | Device communication |
Start the App
- Click Start to launch the TOMMY app
- Enable Start on boot for automatic startup
- Enable Add to sidebar for easy access
Accessing the Dashboard
Once the app is running, you can access the TOMMY dashboard within Home Assistant.
Troubleshooting
- Check app logs in Settings → Apps → TOMMY → Log
- Ensure no port conflicts with other services
- Verify Home Assistant has network access to discover ESP32 devices