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.

Supported Flight Tracking Services
Flightaware
ADS-B Exchange
ADSBHub

Visit dump1090-docker on Docker Hub 🐳 or Github.

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

Using docker-compose
```
docker-compose up -d dump1090
```

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 (after claiming it on Flightaware) 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. To feed data to Flightaware you first must specify your Flightaware username, password, and optionally your FEEDER_ID in flightaware_credentials.txt.
```
docker run --rm -d --link dump1090:beast --name piaware \
    --env-file flightaware_credentials.txt wnagele/piaware
```
  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 .
```
  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
```

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 Claim page under "Linked PiAware Receivers" after running docker-piaware for the first time. There might be multiple, just pick one.

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 docker-adsbexchange images.

Using vanilla Docker
1. Ensure dump1090 is running.
2. Run adsbexchange-feed.
```
docker run --rm -d -e "INPUT=decoder:30005" --link dump1090:decoder \
    --name adsbexchange-feed marcelstoer/adsbexchange-feed:latest
```
3. Optionally run adsbexchange-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-mlat:latest
```
Using docker-compose
1. Start docker-adsbexchange 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
```

docker-adsbexchange 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.

Register for an ADSBHub account.
Register a new ADS-B station.

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

Using vanilla Docker

Ensure dump1090 is running.

Start adsbhub-docker.

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

Using docker-compose
1. Start adsbhub-docker and dump1090.
```
docker-compose up -d adsbhub dump1090
```

Maintenance

Uploading new images to Docker Hub

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

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 .
docker buildx rm my-builder

Supported architectures:

architecture
linux/amd64
linux/arm64
linux/armv7

fnzv/dump1090-docker