Ultrafeeder
Docker app from Eurotimmy's Repository
Ultrafeeder is the SDR-Enthusiasts all-in-one ADS-B container: it decodes 1090 MHz aircraft signals from an RTL-SDR dongle with readsb, shows them on a live tar1090 map, graphs…
Requirements
Overview
Ultrafeeder is the SDR-Enthusiasts all-in-one ADS-B container: it decodes 1090 MHz aircraft signals from an RTL-SDR dongle with readsb, shows them on a live tar1090 map, graphs your reception with graphs1090, and can feed many aggregators (adsb.fi, airplanes.live, ADSBExchange and others) with MLAT.
It also works as a "receiver" for other feeder containers. For example, the FR24/FlightAware all-in-one containers can take their data from Ultrafeeder's Beast output (port 30005) instead of opening the dongle themselves.
:: QUICK START ::
- Plug in your RTL-SDR dongle. Make sure no other container (dump1090, fr24feed-piaware, etc.) is using it.
- Set your receiver latitude, longitude and altitude (metres, e.g. 18m).
- Start the container and open the WebUI. Aircraft should appear within a minute.
:: POWERING AN LNA (BIAS-TEE) ::
If you use a bias-tee powered LNA/filter with an RTL-SDR Blog V3/V4, set "Enable Bias-Tee" to true AND put --enable-biastee in "Extra readsb Arguments". The second setting makes readsb keep the bias-tee on after it opens the dongle; some decoders reset it, which leaves the LNA unpowered and blocking signal.
:: GAIN ::
"auto" uses readsb's built-in auto-gain (recommended by SDR-Enthusiasts). You can also set a fixed value in dB, e.g. 40.2.
:: FEEDING AGGREGATORS ::
Use ULTRAFEEDER_CONFIG to add feeds, e.g. adsb,feed.adsb.fi,30004,beast_reduce_plus_out;mlat,feed.adsb.fi,31090 and set UUID (generate one with: cat /proc/sys/kernel/random/uuid). See the project README for the full list.
This is a community template. It is not affiliated with SDR-Enthusiasts. Please report template problems via the Support link.
Readme
View on GitHubUltrafeeder (ADS-B) for Unraid
Unraid Community Applications template for sdr-enthusiasts/docker-adsb-ultrafeeder. It's an all-in-one ADS-B container with readsb, a tar1090 map, graphs1090 and multi-feeder/MLAT support.
This is a community template. It is not affiliated with SDR-Enthusiasts. Container questions are best asked on the SDR-Enthusiasts project; template questions go to the support link in the template.
Quick start
- Plug your RTL-SDR dongle into the Unraid server. Stop any other container that uses it, such as dump1090 or fr24feed-piaware, because only one container can open a dongle at a time.
- Install Ultrafeeder from Community Applications.
- Fill in Receiver latitude, Receiver longitude and Receiver altitude (for example
18m). - Start it and open the WebUI (default
http://SERVER:8080). Aircraft should appear within a minute. Graphs are at/graphs1090/.
Powering an LNA with the bias-tee
Bias-tee powered LNAs and filters, such as the RTL-SDR Blog ADS-B LNA or a SAWbird, need DC power up the coax from the dongle (RTL-SDR Blog V3/V4).
Set both:
| Setting | Value |
|---|---|
Enable Bias-Tee (READSB_ENABLE_BIASTEE) |
true |
Extra readsb Arguments (READSB_EXTRA_ARGS) |
--enable-biastee |
Why both? Some decoders switch the bias-tee on before starting, then reset it when they open the dongle. Your LNA ends up unpowered, and an unpowered LNA blocks most of the signal. Passing --enable-biastee to readsb makes the decoder itself hold the bias-tee on.
How to tell if your LNA is unpowered: few aircraft, and a noise floor (in /data/stats.json or graphs1090) that barely moves when you change the gain. You can confirm with a multimeter: with the coax disconnected and the container running, expect about 4.5 V DC between the dongle's SMA centre pin and its outer threads.
Using Ultrafeeder as the receiver for other feeders
If you already run an all-in-one feeder such as thomx/fr24feed-piaware for FR24 and FlightAware, let Ultrafeeder own the dongle and point the other container at Ultrafeeder's Beast output.
In fr24feed-piaware set:
SERVICE_ENABLE_BIAST=false
DUMP1090_ADDITIONAL_ARGS=--device-type none
SERVICE_ENABLE_IMPORT_OVER_NETCAT=true
DUMP1090_LOCAL_PORT=30004
DUMP1090_REMOTE_HOST=<your Unraid IP>
DUMP1090_REMOTE_PORT=30005
That container keeps all its feeds (FR24, FlightAware, and the rest) but no longer touches the dongle.
Gain
auto (default) uses readsb's built-in auto-gain, which SDR-Enthusiasts recommend. If you prefer a fixed gain, step it up until you see a small percentage of "strong signals" (above −3 dBFS) during busy traffic, then back off one step.
Feeding aggregators
Add feeds with ULTRAFEEDER_CONFIG and set a UUID. See the project README for the full list. For example:
adsb,feed.adsb.fi,30004,beast_reduce_plus_out;mlat,feed.adsb.fi,31090
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/sdr-enthusiasts/docker-adsb-ultrafeeder:latestRuntime arguments
- Web UI
http://[IP]:[PORT:80]/- Network
bridge- Shell
bash- Privileged
- false
- Extra Params
--device-cgroup-rule='c 189:* rwm' --tmpfs /run:exec,size=256M --tmpfs /tmp:size=128M --tmpfs /var/log:size=32M
Template configuration
tar1090 live map, graphs1090 (/graphs1090/) and stats. Change the host port if 8080 is already in use.
- Target
- 80
- Default
- 8080
- Value
- 8080
Beast data output. Point other feeder containers here (host IP:30005), e.g. fr24feed-piaware with SERVICE_ENABLE_IMPORT_OVER_NETCAT.
- Target
- 30005
- Default
- 30005
- Value
- 30005
SBS (BaseStation) format output for tools such as Virtual Radar Server.
- Target
- 30003
- Default
- 30003
JSON position output.
- Target
- 30047
- Default
- 30047
Your receiver's latitude in decimal degrees, e.g. -28.0875
- Target
- READSB_LAT
Your receiver's longitude in decimal degrees, e.g. 153.3922
- Target
- READSB_LON
Antenna altitude above sea level with unit, e.g. 18m or 60ft
- Target
- READSB_ALT
rtlsdr for RTL-SDR dongles. Other options: modesbeast, gnshulc. Leave empty if this container only receives network data.
- Target
- READSB_DEVICE_TYPE
- Default
- rtlsdr
- Value
- rtlsdr
Optional. Serial number of the dongle to use. Only needed if you have more than one RTL-SDR.
- Target
- READSB_RTLSDR_DEVICE
auto = readsb built-in auto-gain (recommended). Or a fixed value in dB such as 40.2. autogain = legacy slow auto-gain script.
- Target
- READSB_GAIN
- Default
- auto
- Value
- auto
Optional oscillator correction in PPM. Usually not needed for TCXO dongles such as the RTL-SDR Blog V3/V4.
- Target
- READSB_RTLSDR_PPM
true to power a bias-tee LNA/filter through the coax (RTL-SDR Blog V3/V4 and similar). Also add --enable-biastee to Extra readsb Arguments.
- Target
- READSB_ENABLE_BIASTEE
- Default
- false
- Value
- false
Extra arguments passed to readsb. For a bias-tee powered LNA use: --enable-biastee
- Target
- READSB_EXTRA_ARGS
Optional semicolon-separated list of feeds/MLAT/inputs. See the project README (ULTRAFEEDER_CONFIG section).
- Target
- ULTRAFEEDER_CONFIG
Optional. Unique ID sent to aggregators. Generate with: cat /proc/sys/kernel/random/uuid
- Target
- UUID
Optional. Name shown on aggregator MLAT sync maps.
- Target
- MLAT_USER
0 = no location, 1 = 2 decimals, 2 = exact, 3 = 1 decimal, 4 = 0 decimals
- Target
- READSB_RX_LOCATION_ACCURACY
- Default
- 2
- Value
- 2
true to collect range statistics for the graphs1090 polar plot.
- Target
- READSB_STATS_RANGE
- Default
- true
- Value
- true
true to update tar1090 and its aircraft database at container start.
- Target
- UPDATE_TAR1090
- Default
- true
- Value
- true
Title shown on the tar1090 map page.
- Target
- TAR1090_PAGETITLE
- Default
- Ultrafeeder
- Value
- Ultrafeeder
verbose, error or none
- Target
- LOGLEVEL
- Default
- error
- Value
- error
Persistent tar1090 history and readsb state.
- Target
- /var/globe_history
- Default
- /mnt/user/appdata/ultrafeeder/globe_history
- Value
- /mnt/user/appdata/ultrafeeder/globe_history
Persistent graphs1090 data.
- Target
- /var/lib/collectd
- Default
- /mnt/user/appdata/ultrafeeder/graphs1090
- Value
- /mnt/user/appdata/ultrafeeder/graphs1090
Gives the container access to the RTL-SDR USB device.
- Target
- /dev/bus/usb
- Default
- /dev/bus/usb
- Value
- /dev/bus/usb
Read-only, used by graphs1090 for system graphs.
- Target
- /proc/diskstats
- Default
- /proc/diskstats
- Value
- /proc/diskstats