Step 1.

With your SDR UNPLUGGED run this script from your command line, this will install all the pre-requisites.

bash <(wget -q -O - https://raw.githubusercontent.com/sdr-enthusiasts/docker-install/main/docker-install.sh)

Step 2.

Now plug your SDR in and run the following command

lsusb

The output will look something like the below text, take note of the BUS number and DEVICE number

Bus 001 Device 004: ID 0bda:2832 Realtek Semiconductor Corp. RTL2832U DVB-T

Step 3.

Now we are going to create the docker container for readsb. The first command will create a blank file for you to populate

sudo nano docker-compose-readsb.yml

In to this file we are going to paste the container elements, copy the text in bold below and make sure to change the underlined fields to your own specific requirements. Once you have done this press "ctrl + x" to save it and then "y" to confirm.

version: "2.0"

volumes:

readsbpb_rrd:

readsbpb_autogain:

services:

readsb:

image: ghcr.io/sdr-enthusiasts/docker-readsb-protobuf:latest

tty: true

container_name: readsb

hostname: readsb

restart: always

devices:

- /dev/bus/usb:/dev/bus/usb

ports:

- 8080:8080

- 30005:30005

environment:

- TZ=Australia/Perth

- READSB_DCFILTER=true

- READSB_DEVICE_TYPE=rtlsdr

- READSB_FIX=true

- READSB_GAIN=autogain

- READSB_LAT=-33.33333

- READSB_LON=111.11111

- READSB_MODEAC=true

- READSB_RX_LOCATION_ACCURACY=2

- READSB_STATS_RANGE=true

- READSB_NET_ENABLE=true

volumes:

- readsbpb_rrd:/run/collectd

- readsbpb_autogain:/run/autogain

- /proc/diskstats:/proc/diskstats:ro

tmpfs:

- /run/readsb:size=64M

- /var/log:size=32M

Step 4.

We are now going to test this container by using the following command. If everything is working correctly you should see an airport departure style output.

docker exec -it readsb viewadsb

Step 5.

We are now going to create the container for tar1090 first run the command below to create the blank file as with step 3.

sudo nano docker-compose-tar1090.yml

In to the empty file you are going to paste in the text in bold below. Remember to change the fields highlighted to your own specification.

version: "3.8"

services:

tar1090:

image: ghcr.io/sdr-enthusiasts/docker-tar1090:latest

tty: true

container_name: tar1090

restart: always

environment:

- TZ=Australia/Perth

- BEASTHOST=readsb

- LAT=-33.33333

- LONG=111.11111

volumes:

- /opt/adsb/tar1090/globe_history:/var/globe_history

- /opt/adsb/tar1090/timelapse1090:/var/timelapse1090

- /opt/adsb/tar1090/graphs1090:/var/lib/collectd

- /proc/diskstats:/proc/diskstats:ro

# - /run/airspy_adsb:/run/airspy_adsb

ports:

- 8078:80

tmpfs:

- /run:exec,size=64M

- /var/log

Viewing Your Maps

If all has installed correctly you will be available to view your data and maps at the following addresses:

• http://dockerhost:8078/ to access the tar1090 web interface.

• http://dockerhost:8078/?replay to see a replay of past data

• http://dockerhost:8078/?heatmap to see the heatmap for the past 24 hours.

• http://dockerhost:8078/?heatmap&realHeat to see a different heatmap for the past 24 hours.

• http://dockerhost:8078/graphs1090/ to see performance graphs

Step 6.

The final step is to send your data to our servers. Please follow the docker instructions here

To install docker on your system please run the following commands

sudo apt install docker.io -y

sudo snap install docker