jraviles/dump1090 repository overview

⁠Dump1090 Flightaware Docker image

Run dump1090-fa⁠ (Flightaware fork) quickly and easily with Docker! No need to worry about installing drivers or packages.

This repository also includes commands to feed ADS-B data to a handful of flight tracking services, as well as a docker-compose⁠ file to simplify deployment.

Visit dump1090-docker on Docker Hub⁠ :whale:.

⁠Usage

⁠Run

Note, dump1090 needs access to the USB bus to be able to read data from a receiver.

• Using vanilla Docker

  docker run --rm -d --device /dev/bus/usb --name dump1090 -p 8080:8080 jraviles/dump1090:latest
  

  Copy

• Using docker-compose

  docker-compose up -d dump1090
  

  Copy

⁠Starting all services at once

docker-compose up -d

To feed data to Flightaware you first must specify your Flightaware username, password, and optionally your FEEDER_ID in flightaware_credentials.txt⁠.

⁠Building the Docker image locally

docker build -t jraviles/dump1090:latest .

⁠Skyview

dump1090-docker exposes a webserver on port 8080 serving up PiAware Skyview. Skyview is a web portal for viewing flights your receiver is picking up on a map in real time.

⁠Accessing Skyview

Visit http://localhost:8080⁠.

⁠Feeding live flight data to Flightaware

ADS-B data from dump1090-docker can be fed to Flightaware⁠ with the help of docker-piaware⁠.

• Using vanilla Docker

  1. Ensure dump1090 is running.

  2. Run docker-piaware⁠.

     docker run --rm -d --link dump1090:beast --name piaware \
     [--env FEEDER_ID=<feeder id>] wnagele/piaware <flightaware user> <flightaware password>
     

     Copy

     Note, if you're running on a Raspberry Pi or a non-x86 machine, the Piaware image from Docker Hub may not work correctly. If Piaware isn't starting you'll need to build the image yourself.

     git clone https://github.com/wnagele/docker-piaware.git
     cd docker-piaware
     docker build -t wnagele/piaware:latest .
     

     Copy

     You can then use the run command from above.

• Using docker-compose

  1. Start docker-piaware⁠ and dump1090.

     If using docker-compose, you must specify your Flightaware username, password, and optionally your FEEDER_ID in flightaware_credentials.txt⁠.

     docker-compose up -d piaware dump1090
     

     Copy

Setting a FEEDER_ID is optional, but it's best to have as Flightaware uses it to uniquely identify your site. If you don't have a FEEDER_ID you can find it on Flightaware's My ADS-B page⁠ listed as "Unique Identifier" after running docker-piaware for the first time. Screenshot⁠.

See docker-piaware⁠ on Github for more documentation.

⁠Feeding live flight data to ADS-B Exchange

ADS-B data from dump1090-docker can be fed to ADS-B Exchange⁠ with the help of adsbexchange-docker⁠ images.

• Using vanilla Docker

  1. Ensure dump1090 is running.

  2. Run adsbexchange-docker-feed⁠.

     docker run --rm -d -e "INPUT=decoder:30005" --link dump1090:decoder \
     --name adsbexchange-feed marcelstoer/adsbexchange-docker-feed:latest
     

     Copy

  3. Optionally run adsbexchange-docker-mlat⁠.

     Notes:

     1. make sure you replace the dummy values in the command below with your effective values
     2. ADS-B Exchange ask you to enter the receiver GPS coordinates for MLAT⁠ with 5-digit precision
     3. Even though you are giving away the exact receiver position ASD-B Exchange will never disclose this information. To protect the privacy of the feeders, the receiver locations displayed on their maps (e.g. for Central Europe⁠) are approximate only.

     docker run --rm -d -e "INPUT=decoder:30005" -e "MLAT_RESULTS=decoder:30104" \
     -e "RECEIVER_LATITUDE=nn.mmmmm" -e "RECEIVER_LONGITUDE=nn.mmmmm" \
     -e "RECEIVER_ALTITUDE=nnnn" -e "RECEIVER_NAME=my-fantastic-ADS-B-receiver" \
     --link dump1090:decoder --name adsbexchange-mlat marcelstoer/adsbexchange-docker-mlat:latest
     

     Copy

• Using docker-compose

  1. Start adsbexchange-docker⁠ containers and dump1090.

     If using docker-compose, you must specify your MLAT properties in adsbexchange_mlat_properties.txt⁠.

     docker-compose up -d dump1090 adsbexchange-feed adsbexchange-mlat
     

     Copy

adsbexchange-docker⁠ supports ADS-B Exchange custom feeds⁠. To feed data to a custom feed, set the RECEIVER_PORT to that of a feed you have claimed. If unset, adsbexchange-docker will feed the default port: 30005. To set RECEIVER_PORT using docker-compose you must add an environment section⁠ to adsbexchange-feed's service in docker-compose.yml⁠.

⁠Feeding live flight data to ADSBHub

ADS-B data can be fed to ADSBHub⁠ with the help of adsbhub-docker⁠.

1. Register for an ADSBHub account⁠.

2. Register a new ADS-B station⁠.

   Follow instructions on "Adding your ADS-B station to ADSBHub."

3. Run adsbhub-docker⁠.

• Using vanilla Docker

  1. Ensure dump1090 is running.

  2. Start adsbhub-docker⁠.

     docker run --rm -d --link dump1090 --name adsbhub jraviles/adsbhub:latest
     

     Copy

• Using docker-compose

  1. Start adsbhub-docker⁠ and dump1090.

     docker-compose up -d adsbhub dump1090
     

     Copy

⁠Maintenance

⁠Uploading new images to Docker Hub

1. Ensure that Docker >= 19.03 is installed to support buildx⁠.

2. Build and push the new image.

   # Ensure you have run 'docker login'
   export DOCKER_CLI_EXPERIMENTAL=enabled
   docker buildx create --use --name my-builder
   docker buildx build --push --platform linux/amd64,linux/arm64,linux/arm/v7 -t jraviles/dump1090:latest .
   

   Copy

Supported architectures:

⁠Contributors

• Jean-Ralph Aviles⁠
• Marcel Stör⁠