sdr-enthusiasts/docker-JAERO

February 19, 2026 ยท View on GitHub

Docker container for JAERO to receive/decode inmarsat ACARS via zmq from SDRReceiver.


This container is based on the excellent jlesage/docker-baseimage-gui. All the hard work has been done by them, for advanced usage I suggest you check out the README from jlesage/docker-baseimage-gui.


Ports 5800 5900 30003 are exposed by default in this container.

PortMapping to hostDescription
5800MandatoryPort used to access the application's GUI via the web interface.
5900OptionalPort used to access the application's GUI via the VNC protocol. Optional if no VNC client is used.
30003OptionalPort used to serve Basestation data.

Environment Variables

Environment VariableDescriptionDefault
TZYour local timezone in TZ-database-name formatAustralia/Melbourne
DISPLAY_WIDTHVNC display width1920
DISPLAY_HEIGHTVNC display height1080
VNC_PASSWORDVNC passwordUnset
Jaero VariablesDescriptionControls Jaero optionDefault
SET_STATION_IDJaero Station Id (airframes feeder ID)Set Station IDUnset
DISABLE_PLANE_LOGGINGDisable plane loggingDisable plane log windowtrue
ENABLE_BASESTATION_FORMATEnable jaero Basestation outputEnable BaseStation formatfalse
BASESTATION_ADDRESSIP address and port on which to serve basestation dataEnable BaseStation format ip:port window0.0.0.0:30003
BEHAVE_AS_BASESTATION_CLIENTSet to true to enable client behaviourBehave as clientfalse
SDRX_ADDRESSSDRReceiver ip address and port to receive zmq dataAddressUnset
SDRX_TOPIC_NAMESDRReceiver topic nameFirst half of topic settingVFO
NUMBER_OF_SDRX_TOPICSTotal number of jaero configurations to create based on total number of SDRX vfo's, starting at 01 for a maximum of 25. Update SDRX.ini to match.Second half of topic setting3
ENABLE_FEEDINGEnable feedingEnable output feeding using UDPtrue
FEEDERSAdd feeders to upload via UDPAdds feeders under JAERO feeding window with format:host:port1\format=4 1\host=feed.airframes.io 1\port=5571

FEEDERS format for jaero output is 3 for json and 4 for jsondump. Add more feeders by incrementing the first digit. See example entry in docker-compose.yml

Up-and-Running with docker-compose

Once you have installed Docker, you can follow these lines of code to get up and running:

mkdir -p docker-jaero
cd docker-jaero
wget https://raw.githubusercontent.com/sdr-enthusiasts/docker-jaero/main/docker-compose.yml
  • Edit the docker-compose.yml and make any changes as needed.

Start the Container

docker compose up -d
  • Browse to http://your-host-ip:5800 to access the GUI.
  • Set JAERO settings ( speed and locking ) as defined in SDRX.ini