The fast, web-based ham radio logging program supporting real-time, multi-user logging and multiple contest formats.
This guide assumes you already have a server running GNU/Linux or some other UNIX-like operating system from which you intend to host HotLogger.
You'll need PocketBase and Node.js in order to run HotLogger.
Download the latest release tarball or make one using the "building"
instructions below. The file will have a name resembling
hotlogger-a.b.c.tar.gz where a.b.c is the version number.
Extract the archive and go into the resulting directory:
tar xf hotlogger-a.b.c.tar.gz
cd hotlogger-a.b.c/
From that directory, start the database:
pocketbase serve
Now, you're ready to start HotLogger. You have a couple of options. If you just
want to run HotLogger and be reachable from the LAN, you need to specify the
hostname in the HOTLOGGER_ORIGIN environment variable, e.g.:
HOTLOGGER_ORIGIN=http://myhost.local:3000 node hotlogger
If you want to run it behind a reverse proxy such as nginx, you need to specify some different variables:
PROTOCOL_HEADER=x-forwarded-proto HOST_HEADER=x-forwarded-host node hotlogger
By default, HotLogger will bind to port 3000. To change this, set the
HOTLOGGER_PORT environment variable to the desired port.
Once you've started HotLogger using node, you're ready to connect. Open your
browser and navigate to the host you specified in HOTLOGGER_ORIGIN or to your
reverse proxy server.
NOTE: All below commands are to be run from the root of this repository.
This app optionally utilizes NVM.
#if using nvm, and not running automatically
nvm useThis app requires PocketBase.
# install dependencies
npm install
# start database
pocketbase serve
# run local dev server
npm run devTo build a production version:
npm run buildYou can preview the production build with npm run preview.
To assemble a tarball that can be deployed offline:
npm run packageHotLogger is free software released under the terms of the Copyfree Open Innovation License, version 1.0. See COPYING for details.