Skip to content

Receiver Setup Guide

Joseph Prochazka edited this page Oct 18, 2024 · 3 revisions

This guide contains the information you will need to know to set up or upgrading your receiver. It is recommended that you review this information before beginning to setup your receiver. This page contains vital information on how to make certain things work properly before, during, and after setup is complete.

Quick Install Guide

For new installations...

You can download the code and start the installation process by running the following commands.

sudo apt-get update
sudo apt-get install git
git clone https://github.com/jprochazka/adsb-receiver.git ~/adsb-receiver
cd ~/adsb-receiver
chmod +x install.sh
./install.sh

Updating existing installations...

Simply execute the installation script found in the adsb-receiver directory. Your current repository will be updated to the latest code available in the master branch automatically however if you wish to update your local repository manually first execute the git pull command from inside the ~/adsb-receiver directory.

cd ~/adsb-receiver
./install.sh

Portal setup...

Detailed information on setting up the portal with advanced features can be found here.

This step pertains to both fresh installations as well as when updating an existing installation. After running the portal installation scripts you will need to complete the portal setup process by visiting the following web address.

http://<IP_ADDRESS_OF_YOUR_DEVICE>/install/

You may be asked to supply information needed to complete the task. Once done submit the form to complete the setup process.

System Requirements

Operating System

These scripts should work on most current Debian derived Linux distribution. The following is a list of the distribution on which the installation process has been developed and tested on.

  • Armbian (Bookworm, Jammy and Noble)
  • Debian (Bookworm and Bullseye)
  • DietPi (Bookworm and Bullseye)
  • Raspberry PI OS (Bookworm and Bullseye)
  • Ubuntu (Jammy Jellyfish, Focal Fossa and Noble Numbat)

Hardware

Any somewhat up to date desktop/laptop PC or single board computer such as a Raspberry Pi should be capable of running the base installation options outlined below. However, keep in mind depending on the options you select to install your device's CPU load and memory usage will increase which may result in the need for more powerful hardware.

Base dump1090 and the web portal w/ lite options.

  • A device such as a desktop/laptop PC or Raspberry Pi.
  • An RTL-SDR dongle containing a R820T or R820T2 tuner.
  • An antenna tuned to receive the 1090MHz frequency.

The above with dump978 setup as well.

  • An additional RTL-SDR dongle containing a R820T or R820T2 tuner.
  • An additional antenna tuned to receive the 978MHz frequency.

Any of the above utilizing the ADS-B Portal w/ advanced options.

  • A durable data storage medium such as an internal or external hard drive.

It is highly recommended you do not enable advanced portal features on devices using an SD card as its data storage medium.