Docker container running FlightRadar24's fr24feed
. Designed to work in tandem with sdr-enthusiasts/docker-readsb-protobuf. Builds and runs on x86_64
, arm32v6
, arm32v7
& arm64
.
fr24feed
pulls ModeS/BEAST information from the sdr-enthusiasts/docker-readsb-protobuf (or another host providing ModeS/BEAST data), and sends data to FlightRadar24.
For more information on what fr24feed is, see here: share-your-data.
latest
(main
branch,Dockerfile
)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 as Nomad) that don't support manually disabling healthchecks, where healthchecks are not wanted.- Version and architecture specific tags available
First-time users should obtain a Flightradar24 sharing key.
In order to obtain a Flightradar24 sharing key, initially run the container as-per one of the methods below.
Run the following command to temporarily start the container and complete the automated signup process:
docker run \
--rm \
-it \
-e FEEDER_LAT="YOUR_FEEDER_LAT" \
-e FEEDER_LONG="YOUR_FEEDER_LONG" \
-e FEEDER_ALT_FT="YOUR_FEEDER_ALT_FT" \
-e FR24_EMAIL="[email protected]" \
--entrypoint /scripts/signup.sh \
ghcr.io/sdr-enthusiasts/docker-flightradar24:latest
Remember to replace:
YOUR_FEEDER_LAT
with the latitude of your feeder's antennaYOUR_FEEDER_LONG
with the longitude of your feeder's antennaYOUR_FEEDER_ALT_FT
with the altitude of your feeder's antenna above sea level in feet[email protected]
with your email address.
After 30 seconds or so, you should see the following output:
FR24_SHARING_KEY=5fa9ca2g9049b615
FR24_RADAR_ID=T-XXXX123
Take a note of the sharing key, as you'll need it when launching the container.
If the script method fails (please let me know so I can fix it), you can sign up manually.
Temporarily run the container with the following command:
For ARM platforms:
docker run --rm -it --entrypoint /usr/local/bin/fr24feed ghcr.io/sdr-enthusiasts/docker-flightradar24:latest --signup
For other platforms:
docker run --rm -it --entrypoint qemu-arm-static ghcr.io/sdr-enthusiasts/docker-flightradar24:latest /usr/local/bin/fr24feed --signup
This will take you through the signup process. Most of the answers don't matter as during normal operation the configuration will be set with environment variables. I would suggest answering as follows:
Step 1.1 - Enter your email address ([email protected])
: Enter your email address.Step 1.2 - If you used to feed FR24 with ADS-B data before, enter your sharing key.
: Leave blank and press enter.Step 1.3 - Would you like to participate in MLAT calculations?
: Answerno
.Would you like to continue using these settings?
: Answeryes
.Step 4.1 - Receiver selection (in order to run MLAT please use DVB-T stick with dump1090 utility bundled with fr24feed)... Enter your receiver type (1-7)
: Answer7
.Step 6 - Please select desired logfile mode... Select logfile mode (0-2)
: Answer0
.
At the end of the signup process, you'll be presented with:
Congratulations! You are now registered and ready to share ADS-B data with Flightradar24.
+ Your sharing key (xxxxxxxxxxxx) has been configured and emailed to you for backup purposes.
+ Your radar id is X-XXXXXXX, please include it in all email communication with us.
Take a note of the sharing key, as you'll need it when launching the container.
docker run \
-d \
--rm \
--name fr24feed \
-e TZ="YOUR_TIMEZONE" \
-e BEASTHOST=beasthost \
-e FR24KEY=xxxxxxxxxxx \
-p 8754:8754 \
ghcr.io/sdr-enthusiasts/docker-flightradar24:latest
version: '2.0'
services:
fr24feed:
image: ghcr.io/sdr-enthusiasts/docker-flightradar24:latest
tty: true
container_name: fr24feed
restart: always
ports:
- 8754:8754
environment:
- TZ="Australia/Perth"
- BEASTHOST=beasthost
- FR24KEY=xxxxxxxxxxx
There are a series of available environment variables:
Environment Variable | Purpose | Default |
---|---|---|
BEASTHOST |
Required. IP/Hostname of a Mode-S/BEAST provider (dump1090) | readsb |
BEASTPORT |
Optional. TCP port number of Mode-S/BEAST provider (dump1090) | 30005 |
FR24KEY |
Required. Flightradar24 Sharing Key | |
BIND_INTERFACE |
Optional. Set a bind interface such as 0.0.0.0 to allow access from non-private IP addresses |
none |
TZ |
Your local timezone (optional) | GMT |
VERBOSE_LOGGING |
Set to true to enable verbose logging (optional) |
false |
The following ports are used by this container:
8754
- fr24feed web interface - optional but recommended30003
- fr24feed TCP BaseStation output listen port - optional, recommended to leave unmapped unless explicitly needed30334
- fr24feed TCP Raw output listen port - optional, recommended to leave unmapped unless explicitly needed
- The
fr24feed
process is logged to the container's stdout, and can be viewed withdocker logs [-f] container
. fr24feed
log file exists at/var/log/fr24feed.log
, with automatic log rotation.
Having troubles with the container or have questions? Please create a new issue.
I also have a Discord channel, feel free to join and converse.