Installation on a Linux platform (Debian or derivative)

Current version: polaric-aprsd version 2.3, polaric-webapp2 version 1.2

This is a description how to install the Polaric Server software on a Debian based Linux platform. Polaric Server consists of two main components: The APRS daemon (polaric-aprsd) and the Web application (polaric-webapp or polaric-webapp2). In addition there may be plugins. If you are unknown to Linux and Apache system administration, I recommend exploring this a little before attempting to install Polaric Server or that you get help from a friend. If you plan to put up a server permanently on the internet, you should know what you are doing, i.e. you should have at least some knowledge on internet security and firewall setup. I assume you login as 'root' to be able to perform the installation ('sudo su' in Ubuntu).

I haven't tested yet, but I suspect that this description will work on Windows 10 (with WSL and Debian or Ubuntu distro) as well as on a pure Linux system.

Polaric Debian repository

We offer DEB packages to help you install the software. To get started you first need to add a package repository. Do as follows (as root):

echo "deb http://aprs.no/debian-rep binary-dev/" >> /etc/apt/sources.list

This should work on the Debian 'stable' (Buster). It should probably work on 'unstable' or 'testing' as well as recent Debian based distros like Ubuntu, Mint, etc..

You will need to install my cryptographic public key (PGP) to verify the authenticity of repository and the packages. You may do the following. Note that this means that you trust packages signed with my key.

apt-get install gnupg2 dirmngr
gpg --keyserver pool.sks-keyservers.net --recv-keys 89E7229CFFD59B2F
gpg --export --armor 3E61003E24632585EB3DFE3D89E7229CFFD59B2F | apt-key add -

To re-load metadata from the repositories type the command:

apt-get update

Installing the APRS daemon (Polaric-APRSD)

The APRS daemon is a server program that processes APRS data (from/to APRS-IS and/or TNC) and presents it to the web-application (or it may be set up as an igate). It can be run as a standalone application (e.g. as a igate) or function as a backend server for the web-application and can respond to HTTP requests and deliver XML-data or HTML pages.

apt-get install polaric-aprsd

The program will be installed and started automatically. To check that it works, take a look at the log file:

tail -f /var/log/polaric/aprsd.log

If things are ok, you will see new APRS messages arrive. Type q to quit.

You should now configure the server with your callsign and you should also review other configuration parameters like the aprs-is server, passcode, etc.. There is a web-interface for basic configuration. By default, it runs on port 8081. Start your web-browser and type in the url:

http:// <hostname>:8081/config_menu or if the server runs on the same computer: http://localhost:8081/config_menu You will be prompted for a username and a password. The package initially comes with an admin-user ('admin') with password 'polaric'. You should of course change the password. The configuration you usually need to do can be done through this web interface. It covers the most important settings. There are also some setting (for more advanced users) that can by changed manually by editing the file: /etc/polaric-aprsd/server.ini .

For all details, see the configuration reference. Note that configuration through the web interface overrides the manual config in the server.ini file which then can be viewed as default settings.

The server can be restarted through the web config interface or by issuing the command:


Installing the web-application (webapp2)

Webapp2 is the new client software. Source code is on https://github.com/PolaricServer/webapp2. The Debian package installs this automatically assuming that an aprsd instance is running on the same machine. It is possible to install it without aprsd (for advanced users). You can install the web-application component as follows.

apt-get install polaric-webapp2

And you will get a basic installation with OSM (OpenStreetMap) and Norwegian maps. It connects to a local aprsd through port 8081. If you don't install the aprsd, the backend connection will simply fail. You may configure it to use a server at another location if you want to. It also installs mapcache (a plugin for Apache webserver) to cache map-tiles. It depends on the Apache Webserver and will configure it for this application.

By default the webapp can be accessed through http://hostname/aprs

Configuration files

The following config file is important:

/etc/polaric-webapp2/config.js .

Here you may change setup of backend-server, map-layers, default map views and filters: It is a Javascript file which is run on clients, but even if you don't know Javascript very well, it should be fairly self-explanatory wrt. the most important configuration options.

The server runs a mapcache instance. It is configured in:


See mapcache documentation and the explanations in the file itself for more info.

To change the Apache webserver setup for the application edit:


It is possible to add a proxy so that you don't need a separate port for accessing the server from other machines.

Installing plugins

Plugins are optional and easy to install. Plugins with available deb packages are:

  • polaric-ais-plugin. It implements integration of AIS datastream (over TCP). It depends on polaric-aprsd.

install.dev.txt · Last modified: 2020/02/10 15:38 by la7eca
CC Attribution-Share Alike 4.0 International
Powered by PHP Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0 Valid HTML5