Docker dumpvdl2

Docker container for running dumpvdl2 and forwarding the received JSON messages to another system or docker container. Best used alongside ACARS Hub.

Builds and runs on amd64, arm64.

Please note: DUE TO LIBSDRPLAY, THIS CONTAINER WILL NOT RUN ON ARM32 DEVICES

Required hardware

A computer host on a suitable architecture and one USB RTL-SDR dongle connected to an antenna.

Up and running

version: "2.0"

services:
  dumpvdl2:
    image: ghcr.io/sdr-enthusiasts/docker-dumpvdl2:latest
    container_name: dumpvdl2
    restart: always
    ports:
    environment:
      - TZ="America/Denver"
      - RTL_SERIAL=13305
      - FEED_ID=VDLM
      - FREQUENCIES=136.725 136.975 136.875
      - ZMQ_MODE=server
      - ZMQ_ENDPOINT=tcp://0.0.0.0:45555
    tmpfs:
      - /run:exec,size=64M
      - /var/log
    device_cgroup_rules:
      - 'c 189:* rwm'
    volumes:
      - /dev/bus/usb:/dev/bus/usb:ro

Configuration options

Variable	Description	Required	Default
TZ	Your timezone	No	UTC
RTL_SERIAL	The rtlsdr device serial that identifies your dongle.	No	Blank
BIASTEE	Enable biastee when using RTL_SERIAL (doesn't work with SOAPY).	No	Blank
SOAPYSDR	The SoapySDR device string that identifies your dongle. See below for supported soapy sdr types.	No	Blank
SOAPY_DEVICE_SETTINGS	The SoapySDR settings string with comma separated options, example: biastee=true	No	Blank
FEED_ID	Used by the decoder to insert a unique ID in to the output message	Yes	Blank
FREQUENCIES	Semicolon-separated or space-separated list of frequencies for the decoder to listen to. All frequencies should either be in Hz, kHz, or MHz	Yes	Blank
PPM	Parts per million correction of the decoder	No	0
GAIN	The gain applied to the RTL-SDR dongle.	No	40
OVERSAMPLE	Overrides the default oversampling rate used by dumpvdl2. (BROKEN, will kill reception, don't use)	No	Blank
VDLM_FILTER_ENABLE	Filter out non-informational messages. Turning this off (set to a blank value) will cause increased message rate but the messages will be of little value. Will cause extra SD card read/writes.	No	TRUE
VDLM_FILTER	Specify the dumpvdl2 filter string. Used it VDLM_FILTER_ENABLE is true.	No	all,-avlc_s,-acars_nodata,-x25_control,-idrp_keepalive,-esis
QUIET_LOGS	Mute log output to the bare minimum. Set to true to enable.	No	FALSE
ZMQ_MODE	Output to zmq publisher socket. This sets the mode to client or server.	No
ZMQ_ENDPOINT	Output to zmq publisher socket. This sets the endpoint. Syntax is tcp://address:port	No
STATSD_SERVER	Output to a statsd instance.	No	unset

SoapySDR device string

The SoapySDR device string is used to identify your RTL-SDR dongle. The default value is driver=rtlsdr which is suitable for most users. If you are using a different SDR, you will need to provide the correct device string. For example, if you are using an Airspy Mini, you would set SOAPYSDR=driver=airspy. Pass any additional options for the SDR in via this option as well.

Supported Soapy Drivers:

• rtlsdr
• rtltcp
• airspy
• sdrplay