Repository files navigation

Docker container to feed ADS-B data intoadsbexchange. Designed to work in tandem withsdr-enthusiasts/docker-readsb-protobuf or another BEAST provider. Builds and runs on x86, x86_64, arm32v7 & arm64v8.

The container pulls ADS-B information from a BEAST provider and sends data toadsbexchange.

For more information onadsbexchange, see here:ADSBExchange How-To-Feed. This container uses a modified version of the "script method" outlined on that page.

• latest is built from themain branch within 24 hours of a commit to the base image and/or any adsbexchange software included in the image. It contains:
  • Versions ofmlat-client andreadsb specified inadsbxchange/adsb-exchange/setup.sh
  • Latest version ofadsbexchange-stats
  • Latest released version ofrtl-sdr
• latest_nohealthcheck is the same as thelatest version above. However, this version has the docker healthcheck removed. This is done for people running platforms (such asNomad) that don't support manually disabling healthchecks, where healthchecks are not wanted.
• Specific version and architecture tags are available if required, however these are not regularly updated. It is generally recommended to runlatest.

• If you're using this container with thesdr-enthusiasts/docker-readsb-protobuf container to provide ModeS/BEAST data, and the containers are on different docker networks or on different hosts:
  • You'll need to ensure you've opened port30005 (or whatever port is serving BEAST data) into thesdr-enthusiasts/docker-readsb-protobuf container.
  • The IP address or hostname of the docker host running thesdr-enthusiasts/docker-readsb-protobuf container should be passed to thesdr-enthusiasts/docker-adsbexchange container via theBEASTHOST environment variable shown below. The port can be changed from the default of30005 with the optionalBEASTPORT environment variable if required.
• The latitude and longitude of your antenna must be passed via theLAT andLONG environment variables respectively.
• The altitude of your antenna must be passed via theALT environment variable respectively. Defaults to metres, but units may specified with a 'ft' or 'm' suffix.
• A UUID for this feeder must be passed via theUUID environment variable (see below).
• Lastly, you should specify a site name via theSITENAME environment variable. This field supports letters, numbers,- &_ only. Any other characters will be stripped upon container initialization.

First-time users should generate a static UUID using this command:

cat /proc/sys/kernel/random/uuid

Take note of the UUID returned. You should pass it as theUUID environment variable when running the container.

You will be able to view your site's stats by visitinghttps://www.adsbexchange.com/api/feeders/?feed=YOUR-UUID-HERE. The link with your UUID will be printed to the container log when the container starts.

docker run \ -d \ --rm \ --name adsbx \ -e TZ=YOUR_TIMEZONE \ -e BEASTHOST=beasthost \ -e LAT=-33.33333 \ -e LONG=111.11111 \ -e ALT=50m \ -e SITENAME=My_Cool_ADSB_Receiver \ -e UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ --tmpfs=/run:rw,nosuid,nodev,exec,relatime,size=64M,uid=1000,gid=1000 \ ghcr.io/sdr-enthusiasts/docker-adsbexchange:latest

First timers are encouraged to readADS-B Reception, Decoding & Sharing with Docker.

An example docker compose service definition is below:

adsbexchange:image:ghcr.io/sdr-enthusiasts/docker-adsbexchange:latestcontainer_name:adsbxrestart:alwaysenvironment:    -BEASTHOST=beasthost    -TZ=Australia/Perth    -LAT=-33.33333    -LONG=111.11111    -ALT=50m    -SITENAME=My_Cool_ADSB_Receiver    -UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxtmpfs:    -/run:rw,nosuid,nodev,exec,relatime,size=64M,uid=1000,gid=1000

• https://www.adsbexchange.com/myip/
• https://map.adsbexchange.com/mlat-map/

There are a series of available environment variables:

• All processes are logged to the container's stdout, and can be viewed withdocker logs [-f] container.

Please feel free toopen an issue on the project's GitHub.

I also have aDiscord channel, feel free tojoin and converse.