📋
ADS-B Reception, Decoding & Sharing with Docker
  • ADS-B Reception, Decoding & Sharing with Docker
  • Intro
    • Overview
    • How to Get Help
    • What is Docker?
    • Why Docker?
    • Equipment Needed
    • Information Needed
  • Setting Up The Host System
    • Preparing Your System
    • Install Docker
  • Setting Up RTL-SDRs
    • Blacklist Kernel Modules
    • Re-Serialise SDRs
  • Foundations
    • Prepare the Application Environment
    • Deploy "ultrafeeder"
    • Deploy "dump978" (USA Only)
    • Container Monitoring and Management
  • Feeder Containers
    • Feeding Plane.watch
    • Feeding FlightAware (piaware)
    • Feeding FlightRadar24
    • Feeding Airnav Radar
    • Feeding PlaneFinder
    • Feeding ADSBHub
    • Feeding OpenSky Network
    • Feeding RadarVirtuel
  • Useful Extras
    • Storing Data and Metrics in a Time Series Database
    • Graphing Data and Metrics with Influx and Grafana
    • Graphing Data and Metrics with Prometheus and Grafana
    • Auto-Restart Unhealthy Containers
    • Auto-Upgrade Containers
    • Managing a remote station using ZeroTier
Powered by GitBook
On this page
  • docker-install
  • How to run it?
  • Troubleshooting
  • Errors and how to deal with them

Was this helpful?

Edit on GitHub
  1. Setting Up The Host System

Install Docker

docker-install

The docker-install.sh script helps users get ready to use the SDR-Enthusiasts' Docker containers. The script is written to be used on a Debian (Ubuntu, Raspberry Pi OS, or DietPi OS) system that is "barebones", i.e., where Docker has not yet been installed. Debian OS versions Stretch, Buster, and Bullseye are supported.

It will check, and if necessary install the following components and settings:

  • docker

    • install Docker

    • (optional) add the current user to the sudoers group and enable password-free use of sudo

    • configure log limits for Docker

    • configure $PATH environment for Docker

    • add current user to docker group

  • docker compose

    • Install latest stable docker compose plugin

  • Make sure that libseccomp2 is of a new enough version to support Bullseye-based Docker containers

  • Update udev rules for use with RTL-SDR dongles

  • Blacklist SDR drivers so the SDR-Enthusiasts' ADSB and ACARS containers can access the RTL-SDR dongles. Unload any preloaded drivers.

  • on dhcpd based systems, exclude Docker Container-based virtual ethernet interfaces from using DHCP

After running this script, your system should be ready to use docker and docker compose. A sample docker-compose.yml has been included in the docker-install repository if you want to explore extra options after following this guide.

How to run it?

  • Feel free to inspect the script here. You should really not blindly run other people's scripts - make sure you feel comfortable with what it does before executing it.

  • To use it, you can enter the following command:

bash <(curl -s https://raw.githubusercontent.com/sdr-enthusiasts/docker-install/main/docker-install.sh)

Troubleshooting

This script is a work of love, and we don't currently provide support for alternative platforms or configurations. Feel free to reuse those parts of the script that fit your purpose, subject to the License grant provided with the script. If you need help or find a bug, please raise an issue on Github. If you have improvements that you'd like to contribute, please submit a PR.

Errors and how to deal with them

  • ISSUE: The script fails with the message below:

E: Repository 'http://raspbian.raspberrypi.org/raspbian buster InRelease' changed its 'Suite' value from 'stable' to 'oldstable'
E: Repository 'http://archive.raspberrypi.org/debian buster InRelease' changed its 'Suite' value from 'testing' to 'oldstable'

  • SOLUTION: First run sudo apt-get update --allow-releaseinfo-change && sudo apt-get upgrade -y and then run the install script again.

PreviousPreparing Your SystemNextBlacklist Kernel Modules

Last updated 1 month ago

Was this helpful?