Docker container for running airframe's fork of acarsdec 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, ARM32 IS NOT SUPPORTED
A computer host on a suitable architecture and one USB RTL-SDR dongle connected to an antenna.
The default SERVER
and SERVER_PORT
values are suitable for automatically working with ACARS Hub, provided ACARS Hub is on the same pi as the decoder. If ACARS Hub is not on the same Pi, please provide the correct host name in the SERVER
variable. Very likely you will not have to change the SERVER_PORT
, but if you did change the port mapping on ACARS Router (and you will know if you did) please set the server port correctly as well.
SERIAL
has been deprecated in favor of SOAPYSDR
. Please update your configuration accordingly. If SERIAL
is set the driver will be set to rtlsdr
and the serial number will be set to the value of SERIAL
.
version: "2.0"
services:
acarsdec:
image: ghcr.io/sdr-enthusiasts/docker-acarsdec:latest
tty: true
container_name: acarsdec
restart: always
devices:
- /dev/bus/usb:/dev/bus/usb
ports:
environment:
- TZ="America/Denver"
- SERIAL=13305
- FEED_ID=ACARS
- FREQUENCIES=130.025;130.450;131.125;131.550
- OUTPUT_SERVER_MODE=tcp
tmpfs:
- /run:exec,size=64M
- /var/log
Variable | Description | Required | Default |
---|---|---|---|
TZ |
Your timezone | No | UTC |
SOAPYSDR |
The SoapySDR device string that identifies your dongle. See below for supported soapy sdr types. | No | Blank |
FEED_ID |
Used by the decoder to insert a unique ID in to the output message | Yes | Blank |
FREQUENCIES |
Semicolon-separated list of frequencies, to a maximum of 16, for the decoder to listen to | Yes | Blank |
PPM |
Parts per million correction of the decoder | No | 0 |
GAIN |
The gain applied to the RTL-SDR dongle. Recommended to leave at the default autogain. To set manually, gain in in db (0 to 49.6; >52 and -10 will result in AGC; default is AGC) | No | -10 for autogain |
OUTPUT_SERVER |
The server where messages will be forwarded to. | No | acars_router |
OUTPUT_SERVER_PORT |
The port where the server will receive messages on. | No | 5550 |
OUTPUT_SERVER_MODE |
The output mode. udp , tcp and zmq are valid |
No | udp |
MODE |
The output mode. P for planeplotter, J for JSON and A for acarsdec. |
No | J |
QUIET_LOGS |
Mute log output to the bare minimum. Set to false to see all of the log messages. |
No | TRUE |
ACARSDEC_COMMAND_EXTRA |
Additional arguments to pass to the decoder. | No | Blank |
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
TL;DR: No change to your setup is necessary for continued functionality, but you should update your configuration to use the new variables and at least use TCP.
A recent change in the container has meant we are migrating from SERVER
/SERVER_PORT
to OUTPUT_SERVER
/OUTPUT_SERVER_PORT
as a better name for what the variable is representing. The old variables will continue to work for the time being, but please update your configuration to use the new variables. Simply replace SERVER
with OUTPUT_SERVER
and SERVER_PORT
with OUTPUT_SERVER_PORT
. If you do not have SERVER
/SERVER_PORT
set, you do not need to do anything and it will work as it did before.
Generally speaking for a proper migration, whatever your SERVER
was before should be set in your compose as OUTPUT_SERVER
and whatever your SERVER_PORT
was before should be set as OUTPUT_SERVER_PORT
. If SERVER
was not set, you do not have to add in OUTPUT_SERVER
. If you did not have SERVER_PORT
set in your compose, you do not have to add in OUTPUT_SERVER_PORT
unless you want to use zmq
.
Additionally, the OUTPUT_SERVER_MODE
variable has been added to allow for the output mode to be set. The default is udp
and the container will function as it did before. tcp
and zmq
are also valid options and recommended over udp
for reliability.
To use tcp
with acars_router
with the default ports it would have mapped, simply set OUTPUT_SERVER_MODE=tcp
and leave the OUTPUT_SERVER_PORT
as 5550
or unset.
If you wish to use zmq
with acars_router
with the default ports it would have mapped, simply set OUTPUT_SERVER_MODE=zmq
and set OUTPUT_SERVER_PORT
as 35550
.