elafargue / aprsd

APRS daemon for Polaric Server

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Polaric APRSD

The "Polaric Server" is mainly a web based service to present APRS tracking information on maps and where the information is updated in real-time. It is originally targeted for use by radio amateurs in voluntary search and rescue service in Norway. It consists of a web application and a server program (APRS daemon).

The APRS daemon gets data from a TNC or APRS-IS or a combination. It can present and manipulate the information through a simple HTTP service (REST API). The daemon can also be set up as an igate (internet gateway) and can be installed and run independently of the web app. It has its own webserver.

It is recommended to combine it with polaric-webapp2. It supports CORS to allow it to be used with a polaric-webapp2 on another location.

http://aprs.no runs a recent version of this software. More documentation on the project can be found here: http://aprs.no/polaricserver or https://polaricserver.readthedocs.io

System requirements

Linux/Java platform (tested with Debian/Ubuntu) with

  • Java Runtime environment version 11 or later.
  • Scala library version 2.11 or later. You will also need scala-xml and scala-parser-combinators packages.
  • jsvc.
  • librxtx-java (if using serial port for communication with TNC or GPS).
  • libjackson2 (for JSON processing)
  • libcommons-codec

We support deb installation packages for Linux distros that can use it (Debian, Ubuntu, ..) It shouldn't be too hard to port it to e.g. Windows if anyone wants to do the job.

We also use the following external libraries. jar files are included:

  • Jcoord, with some small modifications. Compiled jar and source included.
  • utf8-with-fallback with some small modifications. Compiled jar and source included.
  • Jetty and Spark framework (HTTP server)
  • pac4j framework (authentication/authorization)
  • nano-cuckoo with lz4
  • jMDNS
  • fst with objenesis

Installation

We provide deb (Debian/Ubuntu..) packages. For information on getting started on a Debian based platform please see: https://polaricserver.readthedocs.io/en/latest/gettingstarted.html

Documentation on the project can be found here: http://aprs.no/polaricserver

To configure a standalone server, point your browser to: http://localhost:8081/config_menu

username=admin, password=polaric. Use the command polaric-password to change the password and add new users.

Se also: Examples of how to use it with Docker.

Building from source

Build from the source is done by a plain old makefile. Yes I know :) Maybe I move to something else a little later. Setup for generating deb packages is included. You may use the 'debuild' command.

You will need JDK (Oracle or OpenJDK) version 11 or later, the Scala programming language version 2.11.12 or later.

About

APRS daemon for Polaric Server

License:Other


Languages

Language:Java 88.2%Language:Scala 7.9%Language:Yacc 1.4%Language:Shell 1.1%Language:Makefile 0.6%Language:CSS 0.5%Language:Lex 0.3%