callsigns

This is the code that powers callsigns.ca.
It started with the simple desire for a simple mobile friendly way of
searching the Canadian Callsign Database and ended with me developing
my own website.

Features

* mobile friendly design that also works on the desktop and in the terminal
* bilingual user interface (English and French)
* no advertisements nor any form of monetization (strictly non-commercial)
* no login required to access any part of the site
* no social media buttons to distract you
* no cookies beyond an ephemeral session cookie for language preference
* free and open source code

Requirements

* systemd
* iptables
* nginx
* openssl
* mysql
* wget
* unzip
* node.js
* npm
* letsencrypt

Installation

Grab the source code:

mkdir -p /var/node && cd /var/node
git clone git://github.com/tcort/callsigns.git && cd callsigns

Install the dependencies:

npm install

Configure iptables:

iptables-restore < ./etc/iptables/rules.v4
ip6tables-restore < ./etc/iptables/rules.v6
apt-get install iptables-persistent

Configure:

$EDITOR config.json

Populate the database:

/var/node/callsigns/db/refresh.sh

Add a cron job to refresh the database:

crontab -e
15 1 * /var/node/callsigns/db/refresh.sh >/dev/null 2>&1

Configure rsyslog:

sudo -e /etc/rsyslog.conf
local5.* /var/log/callsigns.log
sudo service rsyslog restart
logger -p local5.info "Test"

Get SSL Certificates:

git clone https://github.com/letsencrypt/letsencrypt
cd letsencrypt
./letsencrypt-auto --agree-dev-preview --server \
https://acme-v01.api.letsencrypt.org/directory certonly

Generate DHE Parameters:

openssl dhparam -out /etc/ssl/certs/dhparam.pem 4096

Configure nginx:

cp /var/node/callsigns/etc/nginx/sites-available/callsigns.ca /etc/nginx/sites-available/callsigns.ca
$EDITOR /etc/nginx/sites-available/callsigns.ca
systemctl restart nginx

Configure the service:

cp /var/node/callsigns/etc/systemd/system/callsigns.service /etc/systemd/system/callsigns.service
systemctl enable callsigns
systemctl start callsigns

Testing

Once the service is up and running, execute npm test to perform some end-to-end tests.

License

Code License: see LICENSE.md

Data License: see Terms and Conditions
on the Industry Canada website.