/rtl_433-docker

A stateless container for the rtl_433 project

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Containerized 433 MHz "listening station"

A stateless container for hosting RTL software defined radio (SDR) projects. The container must have a SDR dongle attached. All signal that are received and decoded will be send over the MQTT (machine-to-machine) protocol to any devices listening.

Usage

Standard build

git clone https://github.com/LinuxChristian/rtl_433-docker.git
cd rtl_433-docker/
docker build -t rtl_433 .

Attaching the dongle

  • Find the RTL-SDR dongle usb bus address using lsusb in the host OS,

    # Example output (System dependent)

    Bus 003 Device 006: ID 0bda:2838 Realtek Semiconductor Corp. RTL2838 DVB-T

  • Attach the usb device to the container

    docker run -d --name rtl_433 --device=/dev/bus/usb/003/006 -e MQTT_IP='10.0.0.1' rtl_433

Environmental variables

The following environmental variables are available,

Name Description
MQTT_IP IP address of MQTT server. Default: 127.0.0.1
MQTT_PASS Password for MQTT server. Default: No password Format: {‘username’:”<usr>”,‘password’:”<pass>”}
MQTT_PORT Port of MQTT server. Default: 1883
MQTT_DEBUG Show debug inforation. Default: True

Credits

MQTT event script largely inspired by work from @kajksa.