Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thom-x/docker-fr24feed-piaware-dump1090
Docker image of dump1090-fa, fr24feed, FlightAware, adsbexchange, Plane Finder, OpenskyNetwork, adsb.fi, ADSBHub and Radarbox.
https://github.com/thom-x/docker-fr24feed-piaware-dump1090
adsbexchange adsbexchange-stats adsbhub docker dump1090 dump1090-fa flightaware flightradar24 fr24 fr24feed opensky-network openskynetwork piaware planefinder radarbox radarbox24 rtl-sdr rtl2832 sdr
Last synced: 5 days ago
JSON representation
Docker image of dump1090-fa, fr24feed, FlightAware, adsbexchange, Plane Finder, OpenskyNetwork, adsb.fi, ADSBHub and Radarbox.
- Host: GitHub
- URL: https://github.com/thom-x/docker-fr24feed-piaware-dump1090
- Owner: Thom-x
- License: mit
- Created: 2016-02-14T12:59:51.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-05T09:47:29.000Z (10 months ago)
- Last Synced: 2024-03-06T18:22:30.880Z (10 months ago)
- Topics: adsbexchange, adsbexchange-stats, adsbhub, docker, dump1090, dump1090-fa, flightaware, flightradar24, fr24, fr24feed, opensky-network, openskynetwork, piaware, planefinder, radarbox, radarbox24, rtl-sdr, rtl2832, sdr
- Language: JavaScript
- Homepage: https://hub.docker.com/r/thomx/fr24feed-piaware
- Size: 88.8 MB
- Stars: 200
- Watchers: 13
- Forks: 51
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fr24feed and FlightAware with dump1090 as a Docker image
[](https://ko-fi.com/T6T1YLGWM)
> Please consider following this project's author, [Thom-x](https://github.com/Thom-x), and consider starring the project to show your ❤️ and support.
Docker image of Fr24feed, FlightAware and dump1090.
Feed FlightRadar24 and FlightAware, allow you to see the positions of aircrafts on a map.
---
# Requirements
- Docker
- RTL-SDR DVBT USB Dongle (RTL2832)
# Getting started
Run :
```
docker run -d -p 8080:8080 -p 8754:8754 \
--device=/dev/bus/usb:/dev/bus/usb \
-v '/etc/localtime:/etc/localtime:ro' \
-e 'FR24FEED_FR24KEY=MY_SHARING_KEY' \
-e 'PIAWARE_FEEDER_DASH_ID=MY_FEEDER_ID' \
-e 'HTML_SITE_LAT=MY_SITE_LAT' \
-e 'HTML_SITE_LON=MY_SITE_LON' \
-e 'HTML_SITE_ALT=MY_SITE_ALT' \
-e 'HTML_SITE_NAME=MY_SITE_NAME' \
-e 'PANORAMA_ID=MY_PANORAMA_ID' \
-e 'LAYERS_OWM_API_KEY=MY_OWM_API_KEY' \
-e 'SERVICE_ENABLE_ADSBEXCHANGE=true' \
-e 'ADSBEXCHANGE_UUID=MY_UUID' \
-e 'ADSBEXCHANGE_STATION_NAME=MY_STATION_NAME' \
-e 'MLAT_EXACT_LAT=MY_EXACT_SITE_LAT' \
-e 'MLAT_EXACT_LON=MY_EXACT_SITE_LON' \
-e 'MLAT_ALTITUDE_MSL_METERS=MY_SITE_ALT_MSL_METERS' \
-e 'SERVICE_ENABLE_PLANEFINDER=true' \
-e 'PLANEFINDER_SHARECODE=dslmfksdlmk' \
-e 'SERVICE_ENABLE_OPENSKY=true' \
-e 'OPENSKY_USERNAME=MY_OPENSKY_USERNAME' \
-e 'OPENSKY_SERIAL=MY_OPENSKY_RECEIVER_SERIAL' \
-e 'SERVICE_ENABLE_ADSBFI=true' \
-e 'ADSBFI_UUID=MY_UUID' \
-e 'ADSBFI_STATION_NAME=MY_STATION_NAME' \
-e 'SERVICE_ENABLE_RADARBOX=true' \
-e 'RADARBOX_SHARING_KEY=MY_RADARBOX_SHARING_KEY' \
-e 'SERVICE_ENABLE_ADSBHUB=true' \
-e 'ADSBHUB_CKEY=MY_ADSBHUB_SHARING_KEY' \
--tmpfs /run:exec,size=32M \
--tmpfs /planefinder/log:exec,size=32M \
--tmpfs /usr/lib/fr24/public_html/data:size=32M \
thomx/fr24feed-piaware
```
Go to http://dockerhost:8080 to view a map of received data.
Go to http://dockerhost:8754 to view the FR24 Feeder configuration panel.
_Note : remove `-e 'PANORAMA_ID=MY_PANORAMA_ID'` or `-e 'LAYERS_OWM_API_KEY=MY_OWM_API_KEY'` from the command line if you don't want to use this feature._
_Note : `--tmpfs` is used to avoid writing data on HDD/SD Card_
_Note : `-v "/etc/localtime:/etc/localtime:ro"` is needed for MLAT, or you can have issues with time synchronization._
# Configuration
## Common
To disable starting a service you can add an environement variable :
| Environment Variable | Value | Description | Default value |
| ----------------------------------- | ------- | -------------------------- | ------------- |
| `SERVICE_ENABLE_DUMP1090` | `false` | Disable dump1090 service | `true` |
| `SERVICE_ENABLE_PIAWARE` | `false` | Disable piaware service | `true` |
| `SERVICE_ENABLE_FR24FEED` | `false` | Disable fr24feed service | `true` |
| `SERVICE_ENABLE_HTTP` | `false` | Disable http service | `true` |
| `SERVICE_ENABLE_IMPORT_OVER_NETCAT` | `false` | Disable import over netcat | `false` |
| `SERVICE_ENABLE_ADSBEXCHANGE` | `false` | Disable adsbexchange feed | `false` |
| `SERVICE_ENABLE_PLANEFINDER` | `false` | Disable plane finder feed | `false` |
| `SERVICE_ENABLE_OPENSKY` | `false` | Disable opensky feeder | `false` |
| `SERVICE_ENABLE_ADSBFI` | `false` | Disable adsb.fi feeder | `false` |
| `SERVICE_ENABLE_RADARBOX` | `false` | Disable radarbox feeder | `false` |
| `SERVICE_ENABLE_ADSBHUB` | `false` | Disable adsbhub feeder | `false` |
Ex : `-e 'SERVICE_ENABLE_HTTP=false'`
## FlightAware
Register on https://flightaware.com/account/join/.
Run :
```
docker run -it --rm \
-e 'SERVICE_ENABLE_DUMP1090=false' \
-e 'SERVICE_ENABLE_HTTP=false' \
-e 'SERVICE_ENABLE_FR24FEED=false' \
-e 'SERVICE_ENABLE_PIAWARE=false' \
thomx/fr24feed-piaware /usr/bin/piaware -plainlog
```
When the container starts you should see the feeder id, note it. Wait 5 minutes and you should see a new receiver at https://fr.flightaware.com/adsb/piaware/claim (use the same IP as your docker host), claim it and exit the container.
Add the environment variable `PIAWARE_FEEDER_DASH_ID` with your feeder id.
| Environment Variable | Configuration property | Default value |
| ---------------------------- | ---------------------- | ------------- |
| `PIAWARE_FEEDER_DASH_ID` | `feeder-id (required)` | empty |
| `PIAWARE_RECEIVER_DASH_TYPE` | `receiver-type` | `other` |
| `PIAWARE_RECEIVER_DASH_HOST` | `receiver-host` | `127.0.0.1` |
| `PIAWARE_RECEIVER_DASH_PORT` | `receiver-port` | `30005` |
Ex : `-e 'PIAWARE_RECEIVER_DASH_TYPE=other'`
## FlightRadar24
Run :
```
docker run -it --rm \
-e 'SERVICE_ENABLE_DUMP1090=false' \
-e 'SERVICE_ENABLE_HTTP=false' \
-e 'SERVICE_ENABLE_PIAWARE=false' \
-e 'SERVICE_ENABLE_FR24FEED=false' \
thomx/fr24feed-piaware /bin/bash
```
Then : `/fr24feed/fr24feed/fr24feed --signup` and follow the instructions. For technical steps, your answer doesn't matter. We just need the sharing key at the end.
Finally, to see the sharing, key run `cat /etc/fr24feed.ini`. You can now exit the container.
Add the environment variable `FR24FEED_FR24KEY` with your sharing key.
| Environment Variable | Configuration property | Default value |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------------- |
| `FR24FEED_RECEIVER` | `receiver` | `beast-tcp` |
| `FR24FEED_FR24KEY` | `fr24key (required)` | empty |
| `FR24FEED_HOST` | `host` | `127.0.0.1:30005` |
| `FR24FEED_BS` | `bs` | `no` |
| `FR24FEED_RAW` | `raw` | `no` |
| `FR24FEED_LOGMODE` | `logmode` | `1` |
| `FR24FEED_LOGPATH` | `logpath` | `/tmp` |
| `FR24FEED_MLAT` | `mlat` | `no` |
| `FR24FEED_MLAT_DASH_WITHOUT_DASH_GPS` | `mlat-without-gps` | `no` |
| `SYSTEM_FR24FEED_ULIMIT_N` | Enforce ulimit like docker <=22 to prevent CPU issues (-1 means not enforced), recommended value when crash 1048576 | -1 |
Ex : `-e 'FR24FEED_FR24KEY=0123456789'`
## ADS-B Exchange
Add the environment variable `ADSBEXCHANGE_UUID` with a UUID generated by .
In case of multiple receivers, please use a different UUID for each receiver.
Add the environment variable `SERVICE_ENABLE_ADSBEXCHANGE` and set it to `true`.
| Environment Variable | Description | Default value |
| ----------------------------- | ------------------------- | ------------- |
| `ADSBEXCHANGE_UUID` | uuid (required) | empty |
| `ADSBEXCHANGE_STATION_NAME` | station name | empty |
| `ADSBEXCHANGE_MLAT` | mlat | `true` |
Configure the MLAT coordinates so that adsbexchange MLAT can work. (see its own section below)
If you don't want to supply your exact coordinates, please set the `ADSBEXCHANGE_MLAT` environment variable to `false`. (you won't get MLAT results and won't contribute to MLAT)
Add the environment variable `ADSBEXCHANGE_STATION_NAME`, it will be used for the mlat map / sync status.
You can check that your MLAT is working correctly by searching for your station name here:
(MLAT map marker is snapped to a 5 mile grid and then offset randomly to avoid stacking markers, the precise lat / lon for MLAT are not publicly accessible at adsbexchange)
The ADS-B Exchange Anywhere map will be available at:
Ex : `-e 'SERVICE_ENABLE_ADSBEXCHANGE=true' -e 'ADSBEXCHANGE_UUID=8398f51e-a61d-11ec-b909-0242ac120002' -e 'ADSBEXCHANGE_STATION_NAME=MyStation'`
## adsb.fi
Add the environment variable `ADSBFI_UUID` with a UUID generated by with `cat /proc/sys/kernel/random/uuid` or `uuidgen` if you don't have `/proc`.
In case of multiple receivers, please use a different UUID for each receiver.
Add the environment variable `SERVICE_ENABLE_ADSBFI` and set it to `true`.
| Environment Variable | Description | Default value |
| ----------------------------- | ------------------------- | ------------- |
| `ADSBFI_UUID` | Uuid (required) | empty |
| `ADSBFI_STATION_NAME` | Station name | empty |
| `ADSBFI_MLAT` | Enable/disable MLAT | `true` |
Configure the MLAT coordinates so that adsbfi MLAT can work. (see its own section below)
If you don't want to supply your exact coordinates, please set the `ADSBFI_MLAT` environment variable to `false`. (you won't get MLAT results and won't contribute to MLAT)
Add the environment variable `ADSBFI_STATION_NAME`, it will be used for the mlat map / sync status.
You can check that your MLAT is working correctly by searching for your station name here:
(MLAT map marker is snapped to a 5 mile grid and then offset randomly to avoid stacking markers, the precise lat / lon for MLAT are not publicly accessible at adsbfi)
The ADS-B Exchange Anywhere map will be available at:
Ex : `-e 'SERVICE_ENABLE_ADSBFI=true' -e 'ADSBFI_UUID=8398f51e-a61d-11ec-b909-0242ac120002' -e 'ADSBFI_STATION_NAME=MyStation'`
## Exact coordinates for MLAT
Get your exact coordinates and altitude above sealevel in meters from one these websites:
-
-
It's important for MLAT accuracy that these aren't off by more than about 10 m / 30 ft.
| Environment Variable | Description | Default value |
| -------------------------- | ------------------------- | ------------- |
| `MLAT_EXACT_LAT` | Decimal latitude | empty |
| `MLAT_EXACT_LON` | Decimal longitude | empty |
| `MLAT_ALTITUDE_MSL_METERS` | Altitude above MSL in m | empty |
## Plane Finder
First-time users should obtain a PlaneFinder Share Code.
In order to obtain a PlaneFinder Share Code, we will start a temporary container running `pfclient`, which will run through a configuration wizard and generate a share code.
Run :
```
docker run -it --rm \
-p 30053:30053 \
-e 'SERVICE_ENABLE_DUMP1090=false' \
-e 'SERVICE_ENABLE_HTTP=false' \
-e 'SERVICE_ENABLE_PIAWARE=false' \
-e 'SERVICE_ENABLE_FR24FEED=false' \
thomx/fr24feed-piaware /planefinder/pfclient
```
Once the container has started, you should see a message such as:
```text
2020-04-11 06:45:25.823307 [-] We were unable to locate a configuration file and have entered configuration mode by default. Please visit: http://172.22.7.12:30053 to complete configuration.
```
At this point, open a web browser and go to . Replace `dockerhost` with the IP address of your host running Docker. You won't be able to use the URL given in the log output, as the IP address given will be the private IP of the docker container.
In your browser, go through the configuration wizard. When finished, you'll be given a PlaneFinder Share Code. Save this in safe place.
You can now kill the container by pressing `CTRL-C`.
Add the environment variable `SERVICE_ENABLE_PLANEFINDER` and set it to `true`.
| Environment Variable | Description | Default value |
| ---------------------------- | --------------------------------- | ------------- |
| `PLANEFINDER_SHARECODE` | generated share code (required) | empty |
Ex : `-e 'SERVICE_ENABLE_PLANEFINDER=true' -e 'PLANEFINDER_SHARECODE=65dsfsd56f'`
## Opensky
First-time users should obtain a Opensky serial.
In order to obtain an Opensky serial, we will start a temporary container running minimal configuration to have opensky up and running, which will generate it.
Run :
```
docker run -it --rm \
-e 'SERVICE_ENABLE_OPENSKY=true' \
-e 'SERVICE_ENABLE_DUMP1090=false' \
-e 'SERVICE_ENABLE_HTTP=false' \
-e 'SERVICE_ENABLE_PIAWARE=false' \
-e 'SERVICE_ENABLE_FR24FEED=false' \
-e 'OPENSKY_USERNAME=OpenskyUsername' \
-e 'HTML_SITE_LAT=45' \
-e 'HTML_SITE_LON=9' \
thomx/fr24feed-piaware /bin/bash
```
Once the container has started, you should see a message such as:
```text
[opensky-feeder] [INFO] [SERIAL] Requesting new serial number
[opensky-feeder] [INFO] [SERIAL] Got a new serial number: -16546546532
```
Note the serial and add it for next run to `OPENSKY_SERIAL` environement variable.
You can now kill the container by pressing `CTRL-D`.
Add the environment variable `SERVICE_ENABLE_OPENSKY` and set it to `true`.
| Environment Variable | Default value | Description |
| ----------------------- | ------------- | --------------------------------------------- |
| `OPENSKY_USERNAME` | empty | Opensky username (required) |
| `OPENSKY_SERIAL` | empty | Generated serial (required after first run) |
| `OPENSKY_DEVICE_TYPE` | `default` | Device type |
| `OPENSKY_INPUT_HOST` | `127.0.0.1` | Input host |
| `OPENSKY_INPUT_PORT` | `30005` | Input port |
| `HTML_SITE_LAT` | `45.0` | Receiver latitude |
| `HTML_SITE_LON` | `9.0` | Receiver longitude |
| `HTML_SITE_ALT` | `0` | Receiver altitude |
Ex : `-e 'SERVICE_ENABLE_OPENSKY=true' -e 'OPENSKY_USERNAME=MyUserName' -e 'OPENSKY_SERIAL=-462168426854'`
## Radarbox
First-time users should obtain a sharing key.
In order to obtain a sharing key, we will start a temporary container running minimal configuration to have radarbox up and running, which will generate it.
Run :
```
docker run -it --rm \
-e 'SERVICE_ENABLE_RADARBOX=true' \
-e 'SERVICE_ENABLE_DUMP1090=false' \
-e 'SERVICE_ENABLE_HTTP=false' \
-e 'SERVICE_ENABLE_PIAWARE=false' \
-e 'SERVICE_ENABLE_FR24FEED=false' \
-e 'HTML_SITE_LAT=45' \
-e 'HTML_SITE_LON=9' \
-e 'HTML_SITE_ALT=0' \
thomx/fr24feed-piaware /bin/bash
```
Once the container has started, you should see a message such as:
```text
[radarbox-feeder] [2023-06-20 18:51:01] CPU Serial empty. Use MAC address instead.
[radarbox-feeder] [2023-06-20 18:51:02] Your new key is 35345bf2258aea6b9c7280fbe4467fcd. Please save this key for future use. You will have to know this key to link this receiver to your account in RadarBox24.com. This key is also saved in configuration file (/etc/rbfeeder.ini)
```
Note the serial and add it for next run to `RADARBOX_SHARING_KEY` environement variable.
You can now kill the container by pressing `CTRL-D`.
Add the environment variable `SERVICE_ENABLE_RADARBOX` and set it to `true`.
| Environment Variable | Default value | Description |
| ----------------------- | ------------- | ------------------------------------------------ |
| `RADARBOX_SHARING_KEY` | empty | Generated sharing key (required after first run) |
| `RADARBOX_INPUT_HOST` | `127.0.0.1` | Input host |
| `RADARBOX_INPUT_PORT` | `30005` | Input port |
| `RADARBOX_MLAT ` | `false` | Enable/disable MLAT |
| `HTML_SITE_LAT` | `45.0` | Receiver latitude |
| `HTML_SITE_LON` | `9.0` | Receiver longitude |
| `HTML_SITE_ALT` | `0` | Receiver altitude |
Ex : `-e 'SERVICE_ENABLE_RADARBOX=true' -e 'RADARBOX_SHARING_KEY=35345bf2258aea6b9c7280fbe4467fcd'`
_Note : You may have this error on windows `[radarbox-feeder] /usr/bin/rbfeeder: line 17: 208 Segmentation fault /usr/bin/rbfeeder_armhf "$@"`, there is no solution to it._
_Note : You may have seg fault error, see https://github.com/mikenye/docker-radarbox/issues/9#issuecomment-633068833 for resolution_
_Note : You may have 'already claimed' error on supplied sharing key, see https://github.com/Thom-x/docker-fr24feed-piaware-dump1090/issues/145_
## Adsbhub
First-time users should obtain a sharing key.
In order to obtain a sharing key, you need to register on https://www.adsbhub.org/ and create a new station under settings, setup the station as follow:
- Station mode: Client
- Feeder Type: Linux
- Data Protocol: Raw
- Station Host(IP): Your public IP
Add the environment variable `ADSBHUB_CKEY` and set it to to the value under "Station dynamic IP update ckey".
Add the environment variable `SERVICE_ENABLE_ADSBHUB` and set it to `true`.
| Environment Variable | Default value | Description |
| ----------------------- | ------------- | -------------------------------------------------- |
| `ADSBHUB_CKEY` | empty | Sharing key for your station to connect to adsbhub |
Ex : `-e 'SERVICE_ENABLE_ADSBHUB=true' -e 'ADSBHUB_CKEY=803BHyyxeHP(%da%DCJfM,}%ftp[9?_j%XR+NktQJUKQ9&UAwQSCWWTvWfPAJQW%i){p2:ih!Y&=wMr*qRDrnC{C,L.C&UgYwB_rw.YG['`
## Add custom properties
**Note** : you can add any property to either fr24feed or piaware configuration file by adding an environment variable starting with `PIAWARE_...` or `FR24FEED_...`.
Example :
| Environment Variable | Configuration property | value | Configuration file |
| -------------------------------- | ---------------------- | -------- | ------------------ |
| `FR24FEED_TEST=value` | `test` | `value` | `fr24feed.init` |
| `FR24FEED_TEST_DASH_TEST=value2` | `test-test` | `value2` | `fr24feed.init` |
| `PIAWARE_TEST=value` | `test` | `value` | `piaware.conf` |
## Dump1090 & Web UI
| Environment Variable | Default value | Description |
| ------------------------------------------ | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `HTML_SITE_LAT` | `45.0` | Receiver latitude |
| `HTML_SITE_LON` | `9.0` | Receiver longitude |
| `HTML_SITE_ALT` | `0` | Receiver altitude |
| `HTML_SITE_NAME` | `My Radar Site` | Receiver name |
| `HTML_DEFAULT_TRACKER` | `FlightAware` | Which flight tracker website to use by default. Possible values are `FlightAware` or `Flightradar24` or `Adsbexchange` or `Planefinder` or `OpenskyNetwork` |
| `HTML_RECEIVER_STATS_PAGE_FLIGHTAWARE` | empty | URL of your receiver's stats page on FlightAware. Usually https://flightaware.com/adsb/stats/user/ |
| `HTML_RECEIVER_STATS_PAGE_FLIGHTRADAR24` | empty | URL of your receiver's stats page on Flightradar24. Usually https://www.flightradar24.com/account/feed-stats/?id= |
| `HTML_RECEIVER_STATS_PAGE_ADSBEXCHANGE` | empty | URL of your receiver's stats page on ADS-B Exchange. Usually https://www.adsbexchange.com/api/feeders/?feed= |
| `HTML_RECEIVER_STATS_PAGE_PLANEFINDER` | empty | URL of your receiver's stats page on PlaneFinder. Usually https://planefinder.net/coverage/receiver/ |
| `HTML_RECEIVER_STATS_PAGE_OPENSKY_NETWORK` | empty | URL of your receiver's stats page on Opensky Netowrk. Usually https://opensky-network.org/receiver-profile?s= |
| `HTML_RECEIVER_STATS_PAGE_RADARBOX` | empty | URL of your receiver's stats page on Radarbox. Usually https://www.radarbox.com/stations/ |
| `HTML_RECEIVER_STATS_PAGE_ADSBFI` | empty | URL of your receiver's stats page on ADSB.fi. Usually https://adsb.fi/ |
| `HTML_RECEIVER_STATS_PAGE_ADSBHUB` | empty | URL of your receiver's stats page on ADSBHub. Usually https://www.adsbhub.org/statistic.php |
| `HTML_FR24_FEEDER_STATUS_PAGE` | empty | URL of your local FR24 Feeder Status page. Usually http://:8754/ (depends on the port you indicated when starting the container) |
| `DUMP1090_ADDITIONAL_ARGS` | empty | Additial arguments for dump1090 e.g.: `--json-location-accuracy 2` |
| `SYSTEM_HTTP_ULIMIT_N` | -1 | Enforce ulimit like docker <=22 to prevent OOM issues (-1 means not enforced), recommended value when crash 1048576 |
Ex : `-e 'HTML_SITE_NAME=My site'`
## DUMP1090 forwarding
| Environment Variable | Default value | Description |
| ----------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
| `SERVICE_ENABLE_IMPORT_OVER_NETCAT` | `false` | Enable netcat forwarding the beast-output of a remote dump1090 server to the local dump1090 beast-input |
| `DUMP1090_LOCAL_PORT` | empty | Must be the same port as specified as `--net-bi-port` in `DUMP1090_ADDITIONAL_ARGS` |
| `DUMP1090_REMOTE_HOST` | empty | IP of remote dump1090 server |
| `DUMP1090_REMOTE_PORT` | empty | Port of remote dump190 server specified as argument `--net-bo-port` on remote system |
## RTL_TCP forwarding
**WARNING:** This kind of forwarding is using a lot of bandwidth and could be unstable in WiFi environments.
| Environment Variable | Default value | Description |
| --------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RTL_TCP_OVER_NETCAT` | `false` | Use dump1090 in combination with netcat to feed data from rtl_tcp server. (Requires appox. 35-40Mbit/s). Example RTL_TCP command: `./rtl_tcp -a 0.0.0.0 -f 1090000000 -s 2400000 -p 30005 -P 28 -g -10` |
| `RTL_TCP_REMOTE_HOST` | empty | IP of rtl_tcp server |
| `RTL_TCP_REMOTE_PORT` | empty | Port of rtl_tcp server |
## Terrain-limit rings (optional):
If you don't need this feature ignore this.
Create a panorama for your receiver location on http://www.heywhatsthat.com.
| Environment Variable | Default value | Description |
| -------------------- | ------------- | ------------------------------------------ |
| `PANORAMA_ID` | empty | Panorama id |
| `PANORAMA_ALTS` | `1000,10000` | Comma seperated list of altitudes in meter |
_Note : the panorama id value correspond to the URL at the top of the panorama http://www.heywhatsthat.com/?view=XXXX, altitudes are in meters, you can specify a list of altitudes._
Ex : `-e 'PANORAMA_ID=FRUXK2G7'`
If you don't want to download the limit every time you bring up the container you can download `http://www.heywhatsthat.com/api/upintheair.json?id=${PANORAMA_ID}&refraction=0.25&alts=${PANORAMA_ALTS}` as upintheair.json and mount it in `/usr/lib/fr24/public_html/upintheair.json`.
## Open Weather Map layers:
If you don't need this feature ignore this.
If you provide an API key OWM layers will be available.
Create an account and get an API key on https://home.openweathermap.org/users/sign_up.
Be aware that OWM provides a free trier for its API, after some time you will have to pay.
See: https://openweathermap.org/price
| Environment Variable | Default value | Description |
| -------------------- | ------------- | ------------------------ |
| `LAYERS_OWM_API_KEY` | empty | Open Weather Map API Key |
Ex : `-e 'LAYERS_OWM_API_KEY=dsf1ds65f4d2f65g'`
# Build it yourself
Clone this repo.
`docker build . `