Installation

Pre-built binaries are available for Windows, macOS, and Linux. Download, run, and Rigbook opens in your browser automatically. If the binaries do not match your use case, the app may be installed from source code on virtually any device.

Rigbook is free, open-source software offered to the ham radio community without warranty of any kind.
License details

🪟 Windows

  1. Download rigbook-windows-amd64.exe.
  2. Double-click the file to run it. Rigbook will open in your default browser.
For detailed step-by-step instructions, see the Windows installation guide.

🍎 macOS

  1. Download rigbook-macos-universal.pkg
  2. Before opening the installer, remove the quarantine attribute (the app is not signed with an Apple developer certificate):
xattr -cr ~/Downloads/rigbook-macos-universal.pkg

Then open the .pkg file and follow the installer prompts to install Rigbook into /Applications. It launches as an app in your web browser

For detailed step-by-step instructions and an alternate no-terminal procedure, see the Mac OS installation guide.

🐧 Linux

Download the binary for your architecture from the Releases page (amd64 for most desktops, arm64 for Raspberry Pi and similar), make it executable, and run it.

# amd64 (most desktops and laptops)
wget https://github.com/EnigmaCurry/rigbook/releases/latest/download/rigbook-linux-amd64
chmod +x rigbook-linux-amd64
./rigbook-linux-amd64

# arm64 (Raspberry Pi, Apple Silicon Linux, etc.)
wget https://github.com/EnigmaCurry/rigbook/releases/latest/download/rigbook-linux-arm64
chmod +x rigbook-linux-arm64
./rigbook-linux-arm64

Keeping Rigbook Updated

🔄 Built-in Updater

Go to Settings → Updates inside Rigbook and enable "Check for new Rigbook releases on GitHub." When a new version is available, a notification appears with an Apply Update button. Rigbook downloads the new binary, swaps it in place, and restarts automatically.

The updater works with official builds from GitHub Releases. If the binary directory is not writable, Rigbook shows a download link instead.

Getting Started

🚀 First Launch

  1. Start Rigbook — it opens http://localhost:8073 in your browser.
  2. The welcome screen guides you through entering your callsign and grid square.
  3. Optionally configure flrig, QRZ, RBN, and HamAlert connections in Settings.
  4. Click + to log your first QSO.