homelabprivacy

Live plane tracking with a $30 RTL-SDR stick and tar1090

🤖 Researched and drafted automatically from the official docs, and reviewed before publishing. Commands are taken from the source projects — but always sanity-check before running anything on your own hardware.

A $30 RTL2832U DVB-T stick or RTL-SDR Blog V4 dongle can receive ADS-B broadcasts at 1090 MHz from aircraft within line-of-sight range. Pair it with readsb or dump1090-fa (the decoders) and tar1090 (the web interface) running on a Raspberry Pi or old laptop to see a live map of planes overhead: callsign, altitude, speed, and flight path. Reception is listen-only; you’re not transmitting anything. Range depends on antenna placement and your location’s terrain.

Prerequisites

You need:

  • An RTL2832U DVB-T stick ($20–30) or RTL-SDR Blog V4 dongle ($30–40)
  • A Raspberry Pi, old laptop, or similar Linux machine (Debian/Ubuntu/Raspbian)
  • A basic antenna (the stick’s antenna works; better results with an external 1090 MHz dipole or colinear)
  • readsb or dump1090-fa already installed and running on the same machine

tar1090 is a web interface layer—it does not replace the decoder. You must have a working ADS-B decoder first.

Install tar1090

  1. SSH into your Pi or Linux machine.

  2. Run the installer:

sudo bash -c "$(wget -nv -O - https://github.com/wiedehopf/tar1090/raw/master/install.sh)"

The script assumes Raspbian, Debian, or Ubuntu and uses apt. It will not work on systems without apt.

  1. Once complete, open a browser on your LAN and navigate to:
http://<your-pi-ip>/tar1090

Replace <your-pi-ip> with the actual IP address of your Pi (e.g., 192.168.1.50).

View live aircraft and historical tracks

  • Live map: http://<your-pi-ip>/tar1090 shows aircraft in real time as they broadcast ADS-B.
  • Historical coverage: http://<your-pi-ip>/tar1090/?pTracks displays the last 8 hours of aircraft traces, giving you a visual map of your receiver’s range.

Configure history retention (optional)

By default, tar1090 keeps 8 hours of track history. To extend it:

  1. Edit the configuration:
sudo nano /etc/default/tar1090
  1. Adjust INTERVAL (seconds between snapshots) and HISTORY_SIZE (number of snapshots stored). Duration in seconds = INTERVAL × HISTORY_SIZE.

  2. Save (Ctrl-X, Y, Enter) and restart:

sudo systemctl restart tar1090

Configure the web interface (optional)

  1. Edit the interface config:
sudo nano /usr/local/share/tar1090/html/config.js
  1. Uncomment settings by removing the // at the start of a line. Examples:

    • flightawareLinks = true; enables Flight Aware links for aircraft.
    • shareBaseUrl = "https://globe.adsbexchange.com/"; lets you share aircraft positions to ADSB-X.
  2. Save and refresh the browser (Ctrl-F5 on the tar1090 page).

Add a theoretical range outline

To see how far you could receive aircraft based on terrain and the Earth’s curvature:

  1. Visit heywhatsthat.com, click “New Panorama”, and set your antenna location precisely.

  2. Once the panorama renders, click “up in the air” and note the panorama ID in the URL.

  3. On your Pi, run:

sudo /usr/local/share/tar1090/getupintheair.sh <PANORAMA_ID>

Replace <PANORAMA_ID> with the ID from your panorama URL. The range outline for 40,000 ft will now appear on your tar1090 map.

Update tar1090

Run the same installer command again:

sudo bash -c "$(wget -nv -O - https://github.com/wiedehopf/tar1090/raw/master/install.sh)"

Configuration is preserved.

Uninstall

sudo bash -c "$(wget -nv -O - https://github.com/wiedehopf/tar1090/raw/master/uninstall.sh)"

Keyboard shortcuts

  • Q / E: Zoom out / in
  • A / D: Pan west / east
  • W / S: Pan north / south
  • C or Esc: Clear selection
  • M: Toggle multiselect
  • T: Select all aircraft
  • B: Toggle map brightness

Security note

Keep tar1090 on your LAN or behind a VPN. Do not expose the web interface to the public internet. If you must access it remotely, use a VPN tunnel to your home network.

Is it worth it?

Yes, if you’re curious about aviation or want to understand RF reception on a budget. A $30 stick and a Pi give you a working ADS-B receiver that rivals commercial flight-tracking hardware. The real win is the visualization: watching planes appear on the map in real time, seeing your actual coverage range, and understanding how radio propagation works in your area. The only gotcha is that you need stable power and a clear view of the sky for the antenna—a window or roof mount beats an indoor placement by an order of magnitude.

Related video

New self-hosted AI & homelab shorts, daily.

Subscribe on YouTube

Related guides

← All guides