va2nw-logger

va2nw-logger is amateur radio contact logging software which emulates paper logs. The goal is to be as simple as a paper log, more convenient than a paper log, and able to export log data.

The ethos is to do one thing and do it well. This is contact logging software, so everything else is omitted. By design there are no spots, no solar conditions, no rig control, no awards tracking, etc. Just logging.

Local Installation

Prerequisites

Install node.js, npm, and git.

Install

git clone https://github.com/tcort/va2nw-logger/
cd va2nw-logger
npm install

Start

npm start

Access

Open your browser and point it at http://localhost:3000/

Cloud Installation

Prerequisites

Install node.js, npm, pm2, nginx, certbot, and git.

Get a domain name (or subdomain) to use for this service.

Install

mkdir -p /usr/local/src && cd /usr/local/src
git clone https://github.com/tcort/va2nw-logger/
cd va2nw-logger
npm install

Launch the service

pm2 start ecosystem.config.js
pm2 save

Nginx Configuration

Generate an http password file to protect your logs (replace YOUR_USER_NAME_HERE with your username):

htpasswd -c /etc/apache2/.htpasswd YOUR_USER_NAME_HERE

Use certbot to generate SSL certificates (replace YOUR_EMAIL_ADDR_HERE with your e-mail address and YOUR_DOMAIN_NAME_HERE with your domain name):

certbot certonly --standalone --agree-tos --email YOUR_EMAIL_ADDR_HERE -d YOUR_DOMAIN_NAME_HERE

Here we configure nginx as a reverse proxy for the node.js service (edit and replace YOUR_DOMAIN_NAME_HERE):

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name YOUR_DOMAIN_NAME_HERE http2;

    ssl_certificate /etc/letsencrypt/live/YOUR_DOMAIN_NAME_HERE/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/YOUR_DOMAIN_NAME_HERE/privkey.pem;

    access_log /var/log/nginx/YOUR_DOMAIN_NAME_HERE.log combined;

    server_tokens off;
    etag off;

    add_header Strict-Transport-Security "max-age=15552000; includeSubDomains; preload";
    add_header X-Content-Type-Options nosniff;
    add_header X-Download-Options noopen;
    add_header X-Frame-Options DENY;
    add_header X-XSS-Protection "1; mode=block";

    if ( $scheme != https ) {
        return 301 https://YOUR_DOMAIN_NAME_HERE$request_uri;
    }

    if ( $host != 'YOUR_DOMAIN_NAME_HERE' ) {
        return 301 https://YOUR_DOMAIN_NAME_HERE$request_uri;
    }

	auth_basic           "Authorized Users Area";
	auth_basic_user_file /etc/apache2/.htpasswd;

	client_max_body_size 10M;

	location / {
		proxy_http_version 1.1;

		proxy_pass http://localhost:3000;
		proxy_redirect off;

		proxy_set_header Upgrade $http_upgrade;
		proxy_set_header Connection "upgrade";
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_set_header Host $http_host;
		proxy_set_header X-NginX-Proxy true;

		proxy_read_timeout 300;
		proxy_connect_timeout 300;
		proxy_send_timeout 300;
	}
}