Giter VIP home page Giter VIP logo

decentrafly-feeder's Introduction

Decentrafly Installation Instructions

Follow these steps to install Decentrafly's Feeder onto your Raspberry Pi Device.

Table of Contents

Installation

To install Decentrafly's feeder, simply run the following one-line command in your terminal:

curl -L https://raw.githubusercontent.com/decentrafly/Decentrafly-Feeder/main/install.sh | bash /dev/stdin  

This installs the services:

  • decentrafly-adsb-forwarder.service (Service to forward ADS-B Beast data to Decentrafly)
  • decentrafly-mlat-client.service (Service to run MLAT locally and establish a secure mTLS connection between Client and Server)
  • decentrafly-mlat-forwarder.service (Service to forward MLAT data over mTLS connection to Server)

Checking-connection

After installing the software, you can check if the ADSB Forwarder service is working by running the following terminal command:

sudo systemctl status decentrafly-adsb-forwarder

Online-confirmation

Confirm your device's status online at:

https://decentrafly.org/checkip

or

Check the Tar1090 map at:

https://globe.decentrafly.org

Account-Signup

To sign up for an account to join the ADS-B Leaderboard:

Navigate to:

https://ui.decentrafly.org/

  • Click on "Signup" at the bottom
  • Complete the form
  • Confirm your email with the verification code
  • Navigate to the "Devices" tab
  • Select "Claim Device"

Your device will now be linked to your account for joining the ADS-B Leaderboard and receiving device health updates.

Log-Files

To check the log files for the ADS-B Forwarder, use the following command:

sudo journalctl -fu decentrafly-adsb-forwarder

Getting-Help

To access the help menu, run the following command:

 decentrafly 

To update to the latest version, run the following command:

 decentrafly upgrade 

If you encounter any issues or need help with the Decentrafly service, please share your log files in our Discord community:

Join our Discord server:

https://discord.gg/VmeAVHaH

Navigate to the #Support channel.

Upload your log files and describe the issue you're experiencing.

Appendix

If you have not updated or installed pip3 follow these steps:

sudo apt update
sudo apt upgrade
sudo apt install python3-pip
pip --version

Setup Remote Access (Optional)

The service:

  • decentrafly-agent.service (Optional service to check device health and diagnostics)

Can be installed by running the optional installation:

decentrafly setup agent

This will enable remote access to the device for diagnostics, only recommended if you have already reached out on Discord for Support from Decentrafly.

Configuration

Installation reads a configuration file to set attributes for feeding at:

/boot/adsb-config.txt

Configuration can be adjusted at:

/etc/decentrafly/config.json
  • DCF_CLIENT_ID: (System provided client ID that identifies this device)
  • DCF_IOT_TOPIC: (System provided topic to stream data to)
  • DCF_LOG_INTERVAL: seconds (integer) between log messages showing stats (default: "20")
  • DCF_MAX_INTERVAL: max seconds (float) to buffer ADSB data before sending it (recommended > 0.2, default "1.0")
  • DCF_READSB_HOST: readsb host to connect to (default: "localhost")
  • DCF_READSB_PORT": beast out port of the readsb (default: "30005")
  • DCF_TRIGGER_SIZE": max bytes to buffer ADSB data before sending it out (default: "50000")

decentrafly-feeder's People

Contributors

decentrafly avatar michael-d-fly avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.