PolaricServer / aprsd

APRS daemon for Polaric Server
Other
25 stars 7 forks source link
aprs aprs-daemon gis ham-radio java web-api web-application

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

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:

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 server, use the webapp2. Some command-line scripts are also available: polaric-setcall, polaric-password,

For first-time login use account: username=admin, password=polaric. Remember to change the password at your fist convenience.

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 (Maven, Gradle) later. Setup for generating deb packages is included. You may use the 'debuild' command.

You will need JDK (Oracle or OpenJDK) version 17 or later.