Welcome to Polaric Server documentation!
The “Polaric Server” is mainly a web based service to present live tracking information (APRS, AIS, etc) on maps and where the information is updated in realtime. 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). It runs on e.g. aprs.no as a online service on the internet, but we could also bring it with us out in the field in a portable computer, possibly with its own LAN, APRS modems and radios. A goal is that it should be able to work without always being online with a good connection to the internet.
Based on free and Open Source software. Open REST API for interoperability.
The user interface is a web application which allows users to browse maps, view and manipulate real-time tracking information using a standard web browser.
Authorized users can, on the server, add information (including APRS objects) and manipulate how objects are displayed in a view shared by all users. For example choice of icons, use descriptive labels (tactical callsigns), tagging, hiding of unnecessary information, etc..
It can integrate live tracking information from various sources in addition to APRS. Examples include AIS and Datex II.
With the client, it is a GIS software that can use many open raster layer sources like e.g. WMS, WMTS, Google Maps or OpenStreetmap. It supports caching/storage of map tiles on server for offline use. It supports vector sources like WFS as well, and file formats like GPX or GeoJSON. It can seamlessly switch between multiple map projections.
Support for drawing features directly on the map. Support for drawing distance circles (bike wheel model).
To help dealing with information overload, servers can be set up with programmable filters and automatic tagging (sysadm can set up rules) to configure what items are displayed as well as how the items are displayed. For example we have full control over trail-lengths, use of labels, etc. Users can select from a set of predefined filters.
Support for APRS messages and bulletins. Support for APRS telemetry (can show graphs)
Can be set up with multiple server instances that can synchronize labels, tags, etc using authenticated APRS messages. Can operate offline with cached map-data. Suitable for small devices like e.g. Raspberry PI and mobile use.
Supports role-based authorization of users. Highly configurable what groups of users may see and do.
Plugin with database support (PostgreSQL with GIS extension) for safe storage of important information and storage and retrieval of tracking (trails) from the past. Useful for looking up information about past missions. Database plugin also supports (eventual consistency) synchronisation of some data with other server instances.
Copyright and license
Polaric Server is free software. See GNU General Public License v.2 and GNU AGPL v.3) Some parts of the source code may use compatible licenses like BSD. Copyright is owned by the respective authors of the software. We also encourage crediting the radio amateur (HAM) community and the Norwegian Radio Relay League for deveopment of APRS technology. If used for a publicly available online service and you make improvements or additions we encourage you to publish these improvements as open source. “APRS” is a registered trademark of Bob Bruninga.
- Getting started
- Advanced Configuration
- Secure communication with server
- Customizing filter script
- Aprsd Configuration Reference
- Interfaces and protocols
- Client authentication
- Server-Server authentication
- REST API for clients
- Client Websocket Services
- Database plugin REST API
- Protocol for remote control