obstruse/piaware repository overview

⁠PiAware

Docker build of PiAware 9.0 + dump1090-fa + OpenLayers + lighttpd, for Raspberry Pi.

https://github.com/obstruse/PiAware-Docker⁠
https://hub.docker.com/r/obstruse/piaware⁠

Intended for use on LibreELEC(Kodi) with Docker and Portainer addons.

⁠Hardware

• Raspberry Pi 3 (e.g.: https://www.adafruit.com/product/3775⁠)
• RTL-SDR Dongle (e.g.: https://www.rtl-sdr.com/buy-rtl-sdr-dvb-t-dongles/⁠ )

⁠Prepare Raspberry Pi

⁠Install LibreELEC

Boot the Pi using LibreELEC from PINN (PINN Is Not NOOBS):

https://sourceforge.net/projects/pinn/⁠

or using the LibreELEC installer:

https://libreelec.tv/downloads/⁠

⁠Enable SSH

• Kodi main menu -> Add-ons -> LibreELEC Configuration -> Services -> Enable SSH

⁠Blacklist RTL Kernel Module

• Connect using SSH and create the blacklist file:

echo 'blacklist dvb-usb-rtl28xxu' > /etc/modprobe.d/blacklist-rtl28xxu.conf

• Reboot

⁠Install Add-ons:

Install the Docker add-on :

• Kodi main menu -> Add-ons -> Install from repository

• LibreELEC Add-ons -> Services -> Docker

Install the Portainer add-on:

• LibreELEC Add-ons -> Add-on Repository -> LinuxServer.io's Docker Add-ons

• Kodi main menu -> Add-ons -> Install from repository
• LinuxServer.io's Docker Add-ons -> Services -> Portainer

⁠Install Piaware

Access Portainer at: http://192.168.1.12:9000⁠ (replace the IP with the address of your Raspberry Pi)

⁠Add tmpfs Volume

• Volumes -> Add volume
  • Name: run
  • Driver: local
  • Driver options -> add driver option
    • name: device
    • value: tmpfs
  • Driver options -> add driver option
    • name: type
    • value: tmpfs
  • Driver options -> add driver option
    • name: o
    • value: size=20m,uid=1000
  • Use NFS volume: off
  • Use CIFS volume: off
  • Enable access control: off
• Click Create the volume

⁠Deploy Container

• Containers -> Add container
  • Container name: Piaware
  • Image configuration Name: obstruse/piaware
  • Port mapping
    • 8180 -> 8080 (to avoid conflict with Kodi on 8080)
    • 30005 -> 30005 (data in Beast format)
    • 30105 -> 30105 (MLAT data in Beast format)
  • Disable Access control
  • Console: Interactive & TTY
  • Volumes -> map additional volume
    • Container: /run Volume
    • volume: run - local Writable
  • Restart policy: Unless stopped
  • Runtime & Resources: Privileged Mode
• Click Deploy the container

The PiAware Skyview web page will be available on port 8180 on your Raspberry Pi; the OpenLayers3 web page will be available on port 8181.

⁠Claim your PiAware client on FlightAware.com

https://flightaware.com/adsb/piaware/claim⁠

⁠Set Location and Height of Site

Go to your stats page:

https://flightaware.com/adsb/stats/user/yourusername⁠

Click on the gear icon to the right of your site name, and configure location and height.

⁠Changing Feeder ID

The feeder ID is assigned when the feeder first connects, and is stored in the PiAware instance. If you redeploy PiAware, a new feeder ID is assigned and will look like a new site on FlightAware. If you want to continue using the same site after redeploying, you need to manually reconfigure the feeder ID.

• Find the feeder ID that you want to use. Go to: https://flightaware.com/adsb/stats/user/yourusername⁠. The feeder ID is labeled "Unique Identifier",
• Using Portainer, open a console on the PiAware instance and enter:

piaware-config feeder-id

• Paste the unique identifier.
• Restart piaware