Differences

This shows you the differences between two versions of the page.

--- packet:linbpq-apt-installation [2024/06/18 23:55] – Adding the script mm0rfn
+++ packet:linbpq-apt-installation [2025/07/30 09:35] (current) – m0lte
@@ Line 1: / Line 1: @@
 ====== LinBPQ Installation using apt ======
-This process is suitable for Debian-based operating systems, e.g. Debian, Raspberry Pi OS, Ubuntu.
+This is the way which OARC recommends installing LinBPQ.
+It is suitable for Debian-based operating systems, e.g. Debian, Raspberry Pi OS. It does not ship for Ubuntu (yet?).
 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.**
+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. Always take backups.
-===== Preparation =====
-**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.
-There are two ways of installing the repo: script or manually line.
-==== Script ====
-The script requires dowloaded, set to executable and run and is a little simpler than the manual setup - thanks to John M5ET for writing it!
-I strongly recommend you read through it **before** running it - it should look similar to the manual method below.
-**General computer security advice is to not blindly run scripts you downloaded from the internet!**
-Download the script from: [[https://guide.foxk.it/static/files/setup.sh]]
-Lines you can run in the command line are:
-<code>
-cd /tmp
-wget https://guide.foxk.it/static/files/setup.sh
-chmod +x /tmp/setup.sh
-sudo bash /tmp/setup.sh
-</code>
-==== Manually ====
-To start using his repo, you need tell your machine to trust the repo:
-<code>
-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
-</code>
-Then you need to add the repo for your OS:
-<code>
-# 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'
-# Ubuntu 24.04 LTS amd64
-sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages noble 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'
-</code>
-===== Installation =====
-After following the above steps, to install LinBPQ, run the below commands:
-<code>
-sudo apt update
-sudo apt install linbpq
-</code>
-LinBPQ runs as a background service and requires a config file - see the next sections for details.
+Follow this guide: https://guide.hibbian.org/install/bpq/
-===== Configuration =====
-A default config file will need to be placed at ''/etc/bpq32.cfg'' before bpq will start.
+===== Tips =====
-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
+A default config file will be placed at ''/etc/bpq32.cfg'' before bpq will start.
-<code>
+We ship a backup config file suitable for a basic node with a single KISS modem with the package in `/usr/share/doc/linbpq/examples/bpq32.cfg`, so don't worry about getting it wrong!
-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
-</code>
 Whenever you have updated the [[https://www.cantab.net/users/john.wiseman/Documents/BPQCFGFile.html|config]], restart LinBPQ: