Installation
Home Assistant Installation
Install TOMMY as a Home Assistant add-on, integrating with your Home Assistant instance.
Requirements
- Home Assistant OS
- AMD64 or ARM64 architecture
Recommended Installation Method
Installing TOMMY as a Home Assistant add-on is the most integrated approach.
Installation Steps
Add the TOMMY Repository
Click the button below to add the TOMMY repository to your Home Assistant instance:
Or manually add the repository:
- Navigate to Settings → Add-ons → Add-on 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 Add-on
- Refresh the Add-on Store page
- Find "TOMMY" in the list of available add-ons
- Click on the TOMMY add-on
- Click Install
Configure the Add-on
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 Add-on
- Click Start to launch the TOMMY add-on
- Enable Start on boot for automatic startup
- Enable Add to sidebar for easy access
Accessing the Dashboard
Once the add-on is running, you can access the TOMMY dashboard within Home Assistant.
Troubleshooting
- Check add-on logs in Settings → Add-ons → TOMMY → Log
- Ensure no port conflicts with other services
- Verify Home Assistant has network access to discover ESP32 devices