Skip to content

Installation

Prerequisites

You need:

  1. Home Assistant OS or another Supervisor-based installation that supports add-ons.
  2. An SDR supported by rtl_433, usually an RTL-SDR USB dongle.
  3. Wireless sensors supported by rtl_433.
  4. The companion rtl_433 Home Assistant integration to create Home Assistant devices and entities from the decoded data. Install it before starting the add-on.

The upstream rtl_433 hardware and protocol references are useful when choosing radios and sensors:

Install the Integration First

Install the companion rtl_433 integration and restart Home Assistant before starting the add-on. The order matters: the add-on publishes Supervisor discovery data for each radio when it starts, and the discovered rtl_433 cards only appear if the integration is already loaded. With the integration in place first, every radio shows up under Settings -> Devices & Services ready to add with one click — no host or port needs to be typed.

Add the Repository

  1. In Home Assistant, open Settings -> Apps -> App Store (called Settings -> Add-ons -> Add-on Store before Home Assistant 2026.2).
  2. Open the menu and choose Repositories.
  3. Add https://github.com/rtl-433-hass/rtl_433-hass-addons.
  4. Install rtl_433 for the stable add-on, or rtl_433 (next) if you intentionally want the development build.

Start the Add-on

  1. Plug the SDR dongle or dongles into the Home Assistant host.
  2. Start the add-on.
  3. Open the add-on log and look for one line per radio similar to:
Add-on configuration directory: /addon_configs/<slug>/ (browse it with the File Editor, Samba, or the VS Code add-on; it is NOT Home Assistant's own /config folder).
Radio <id> -> HTTP port <port>. To customize, create /addon_configs/<slug>/<id>.conf.
Radio <id>: unique_id=<serial:...|usbpath:...> host=<host> port=<port>

The <id> identifies the radio for per-radio override files. The unique_id — shown as either a serial: or a usbpath: value — together with the host and port identifies the radio for the Home Assistant integration.

The log prints the override path exactly as you see it from Home Assistant (File Editor, Samba, or the VS Code add-on), with <slug> already filled in. That directory is not Home Assistant's own /config folder. See Per-Radio Overrides.

Connect Home Assistant

If the integration was installed first, each detected radio appears as a discovered rtl_433 card under Settings -> Devices & Services. Click Add and confirm — that's it.

If no discovery card appears (for example, the integration was installed after the add-on started), install the integration, restart Home Assistant, and then restart the add-on so it republishes discovery. Alternatively, add one hub per radio manually with these values:

Field Value
Host The add-on host shown in the add-on log or Supervisor discovery
Port 8433 for the first radio, 8434 for the second, and so on
Path /ws
Secure Off

The add-on's built-in config already includes output http://0.0.0.0:<port>, so you do not need to add an output line yourself.

Development Add-on

rtl_433 (next) is a rolling development build. It includes unreleased add-on changes and the latest available upstream rtl_433 source at build time. Use it when you need a development fix or newer upstream decoder support and are comfortable with a less stable channel.

To find the upstream rtl_433 commit in use, check the add-on log. rtl_433 prints a version line such as:

[rtl_433] rtl_433 version 22.11-89-g416d6c4f branch master at 202302071819 inputs file rtl_tcp RTL-SDR

Drop the leading g from g416d6c4f to get the upstream commit hash.