This process is suitable for Debian-based operating systems, e.g. Debian, Raspberry Pi OS, Ubuntu.

This page and the package it refers to are NOT the first party documentation or packaging for LinBPQ.

This process is only fully tested for a clean installation where BPQ has not been manually installed in the past using some other means. There are some high level instructions at the bottom of this page. If you aren't sure, stop and seek help.

Do this once, only.

Our very own Hibby MM0RFN, also a Debian maintainer, has kindly packaged and is maintaining various Linux packet radio software, among them LinBPQ.

To start using his repo, you need tell your machine to trust the repo:

wget -q https://online-amateur-radio-club-m0ouk.github.io/oarc-packages/hibby.key
sudo mv hibby.key /etc/apt/trusted.gpg.d/hibby.asc

Then you need to add the repo for your OS:

# Ubuntu 22.04 LTS amd64
sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages jammy main" >> /etc/apt/sources.list'

# Raspberry Pi OS 12 - 'Bookworm'
sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list'

# Raspberry Pi OS 11 - 'Bullseye'
sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bullseye main" >> /etc/apt/sources.list'

# Debian 13 amd64
sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages testing main" >> /etc/apt/sources.list'

# Debian 12 amd64
sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list'

Do this once, only.

After following the above steps, to install LinBPQ, run the below commands:

sudo apt update
sudo apt install linbpq

LinBPQ runs as a background service and requires a config file - see the next sections for details.

A default config file will need to be placed at /etc/bpq32.cfg before bpq will start.

We ship a simple config file suitable for a basic node with a single KISS modem with the package in `/usr/share/doc/linbpq/examples/bpq32.cfg`, taken from: https://gist.github.com/M0LTE/52824537b3fe21d19baf9a66eda4db86

sudo cp /usr/share/doc/linbpq/examples/bpq32.cfg /etc/bpq32.cfg
# edit as required, then:
sudo chown :linbpq /etc/bpq32.cfg
sudo chmod 664 /etc/bpq32.cfg

Whenever you have updated the config, restart LinBPQ:

sudo systemctl restart linbpq

Check on its status:

sudo systemctl status linbpq

Show its logs:

journalctl -ru linbpq

(use arrows / page up/down to navigate, press q to quit)

There are various ways to access your node locally:

in a browser, e.g. http://yournode:8008

using QtTermTCP, a cross-platform GUI with some more advanced features for monitoring etc, connecting to port 8011

using Telnet (e.g. PuTTY in Telnet mode), connecting to port 8010

Username and password as per your config file.

If you get “No APPLCALL for Chat APPL” in the BPQ logs, and “Sorry, Application CHAT is not running” when you issue CHAT at the node prompt, ensure that the ApplNum in /opt/oarc/bpq/chatconfig.cfg is set to the number of the APPLICATION in /opt/oarc/bpq/bpq32.cfg. You can also do this in Chat Mgmt in the BPQ web interface.

To update LinBPQ to the latest version in Hibby's apt repo, simply:

sudo apt update
sudo apt upgrade

1. stop existing bpq running
2. back everything up!
3. make note of locations of files - we're particularly interested in bpq32.cfg and the working files. This will be the directory holding chatconfig.cfg, axipcache.cfg, BPQNODES.dat, DIRMES.SYS. If you're using the plain binary of bpq I think it just puts all that stuff beside it.
4. install from apt, then sudo systemctl stop linbpq
5. copy bpq32.cfg from wherever it is - to where it needs to be sudo cp bpq32.cfg /etc/bpq32.cfg and update owner sudo chown root:linbpq /etc/bpq32.cfg
6. copy working files and folders from where they are to /opt/oarc/bpq/ - as an example, sudo cp -rf /home/pi/bpq/ /opt/oarc/bpq/ and update owner - sudo chown -R linbpq:linbpq /opt/oarc/bpq/
7. start new install with sudo systemctl start linbpq and see if anything explodes

This document superseded linbpq_pc_installation and linbpq_pi_installation.