Fresh Raspberry Pi or Armbian Core install
Install the headless nereusd Core on a fresh 64-bit Debian 13 (Trixie)
system. Use Raspberry Pi OS Lite (64-bit), Trixie on a Pi, or a compatible
Armbian Minimal/CLI Debian Trixie image for your board. The release's
arm64_trixie.deb is the matching package; the Ubuntu ARM64 .deb is a
different build. Development used a Raspberry Pi 4 and a 2 GB Radxa Rock 5C.
These steps set up a standalone SBC with a wired connection to the radio. For an ANAN-G2's built-in Pi, follow its Saturn-specific setup as well; the radio image has components beyond the Core.
1. Prepare the card
Use Raspberry Pi Imager or the
Armbian image for your board. Choose the
64-bit Trixie image, set your own user/password and a hostname such as
nereus-core, and enable SSH. Connect both the Pi and the radio by Ethernet
to the same switch, or plug the radio directly into the Pi's Ethernet port
and follow Radio plugged directly into the Pi
before continuing. On Armbian, use Direct radio cable on Armbian.
For the direct cable setup, also configure Wi-Fi in
Raspberry Pi Imager or use a USB Ethernet adapter so your apps can reach the
Pi and it can download the package.
Keep the radio-to-Core connection wired. The radio should always connect by Ethernet, either directly to the Pi or to the same switch as the wired Pi. A Core that reaches the radio over Wi-Fi stutters. Connect a keyboard or use:
ssh YOUR_USER@nereus-core.local
2. Check the OS and install download tools
These commands stop if the system is not ARM64 Trixie.
(
set -eu
[ "$(dpkg --print-architecture)" = arm64 ] || { echo "Use a 64-bit ARM64 image." >&2; exit 1; }
. /etc/os-release
[ "${VERSION_CODENAME:-}" = trixie ] || { echo "Use a Debian Trixie image." >&2; exit 1; }
sudo apt update
sudo apt install -y ca-certificates curl gnupg avahi-daemon nano
)
3. Download and install the Core
Use the matching Trixie package from the selected release's Assets. The example below installs 2026.10.1. Copy the whole command block into the terminal. It downloads the public signing key over HTTPS, checks its full fingerprint, then verifies the signed checksum list and the package before installing. Verification uses a temporary keyring.
(
set -eu
release_version=2026.10.1
core_package="nereusd_${release_version}_arm64_trixie.deb"
release_url="https://github.com/boydsoftprez/NereusSDR/releases/download/v${release_version}"
GNUPGHOME=$(mktemp -d)
export GNUPGHOME
trap 'rm -rf "$GNUPGHOME"' EXIT HUP INT TERM
curl -fL -o "$GNUPGHOME/signing-key.asc" https://nereussdr.com/nereussdr-signing-key.asc
gpg --batch --with-colons --show-keys "$GNUPGHOME/signing-key.asc" > "$GNUPGHOME/key-info"
fingerprint=$(awk -F: '$1 == "pub" { primary = 1; next } primary && $1 == "fpr" { print $10; primary = 0 }' "$GNUPGHOME/key-info")
[ "$fingerprint" = 4A95F4D22AEE9271D8A3C01B20C284473F97D2B3 ] || { echo "Signing key fingerprint mismatch." >&2; exit 1; }
gpg --batch --import "$GNUPGHOME/signing-key.asc"
curl -fLO "$release_url/$core_package"
curl -fLO "$release_url/SHA256SUMS.txt"
curl -fLO "$release_url/SHA256SUMS.txt.asc"
gpg --batch --verify SHA256SUMS.txt.asc SHA256SUMS.txt
awk -v file="$core_package" '
$2 == file { row = $0; count++ }
END {
if (count != 1) { print "Expected exactly one package checksum." > "/dev/stderr"; exit 1 }
print row
}
' SHA256SUMS.txt > "$GNUPGHOME/package.sha256"
sha256sum --check --strict "$GNUPGHOME/package.sha256"
sudo apt install "./$core_package"
)
GPG may report that the key is not certified with a trusted signature. That warning is expected in a temporary keyring; the full fingerprint check above identifies the release key. A bad signature, fingerprint mismatch or failed checksum stops the commands before installation.
apt installs the declared runtime dependencies. If they cannot be resolved,
check that the image is ARM64 Debian Trixie; use its normal repositories and
a matching package. Installation leaves the radio service disabled until the
next step.
Packages newer than 2026.10.0 also change one system setting when they are
installed: they raise Linux's network receive buffer limit
(net.core.rmem_max) to the 4 MB the Core asks for on the socket its radio
sends to, and apt prints a line saying what it did. A limit that is already
higher is left alone. The file that does it is /usr/lib/sysctl.d/10-nereusd.conf,
and removing the package removes it. The
README
says what it is for and how to undo it.
4. Configure and start it
On this fresh installation, copy the sample and review it. With one visible
LAN radio, leave radio_mac empty; with several, set the intended radio's
MAC. The sample enables the Core listener, local status page and RV/relay
access. remote_transmit controls whether paired clients may transmit.
sudo install -m 0644 /usr/share/nereusd/nereusd.conf.sample /etc/nereusd.conf
sudo nano /etc/nereusd.conf
sudo systemctl enable --now nereusd
sudo nereusd status
The service now starts automatically at boot. First start generates and caches FFTW plans; give it time to become ready.
Core speaker and serial accessories
The Core can play received audio on the SBC's own sound card, and it can turn a rotor or run serial CAT on a USB serial adapter. Linux gives both devices to groups the Core does not belong to, so each needs a small systemd drop-in.
- Sound card. The
.debpackage ships the audio drop-in (/usr/lib/systemd/system/nereusd.service.d/audio.conf), so there is nothing to add. An older install without it needs/etc/systemd/system/nereusd.service.d/audio.confholding[Service]andSupplementaryGroups=audio. - Serial adapter. The
.debpackage does not ship the serial grant. Until you add it, the Core cannot open/dev/ttyUSB*or/dev/ttyACM*, so a GS-232 rotor and serial CAT will not connect. Create/etc/systemd/system/nereusd.service.d/serial.confwith the two lines[Service]andSupplementaryGroups=dialout, then runsudo systemctl daemon-reloadandsudo systemctl restart nereusd. Thedialoutname is right for Raspberry Pi OS and Armbian; the Pi 4 and Rock installer scripts write both drop-ins for you. - Choose the Core speaker. In any window signed in to the Core, open Audio > Outputs and use the Core speaker card, or use the Sound panel on the iPhone or iPad. The Core speaker needs a 2026.10.1 Core.
- Check the card's mixer. A sound card can be open and playing while its
own mixer has the output switched off. On a board with a DAC, check that its
DAC switches are on (
alsamixeroramixer -c <card>). NereusSDR does not change a card's mixer. - Real-time priority. Some vendor kernels, the Rock 5C's among them,
refuse real-time scheduling to every service while the system's CPU
controller is on, and on Debian any login switches it on. The Core then logs
"Raised thread priority was refused" and its audio threads run at normal
priority. The Rock installer writes a drop-in,
/etc/systemd/system/user@.service.d/nereusd-realtime-priority.conf, meant to keep logins from switching the controller on; this is not yet confirmed on a Rock. It takes effect for logins after it is written, so restart the Rock once after installing. To see whether the controller is on, look forcpuincat /sys/fs/cgroup/cgroup.subtree_control. Check how heavily the board is loaded if audio breaks up.
5. Pair a console
Open NereusSDR on the desktop or the native iPhone/iPad app and choose the Core found on your home network. Follow the pairing prompt. To display a pairing code on the SBC:
sudo nereusd pairing show
The local status page is http://nereus-core.local:47911 if you used that
hostname. It shows the pairing code while the Core is unclaimed. Core Settings
shows the connected station and its actual audio/network path.
Radio plugged directly into the Pi
If the radio's Ethernet cable goes straight into the Pi, with no switch or router in between, run these commands once. They tell the Pi's Ethernet port to use a link-local address when no router answers. It still uses a router's address if you later plug it into your LAN.
These commands are for Raspberry Pi OS Trixie with NetworkManager 1.52 or newer. First check the version and find the name of the Pi's Ethernet connection:
nmcli --version
nmcli -f NAME,TYPE,DEVICE connection show
Choose the Ethernet connection for eth0, usually Wired connection 1.
Use its full name, inside the quotes, in place of CONNECTION below. If
your Ethernet device has a different name, replace eth0 as well. Apply
the setting from a local keyboard or an SSH connection over Wi-Fi or the
USB Ethernet adapter:
sudo nmcli connection modify "CONNECTION" ipv4.method auto ipv4.link-local fallback
sudo nmcli connection up "CONNECTION"
ip -4 address show dev eth0
On a direct cable, the last command should show an address starting with
169.254. Once that address appears, the Core normally finds a radio using
automatic addressing within a few seconds. If a router is connected instead,
expect the router's address rather than 169.254.
Your apps still need a way to reach the Pi. Its built-in Ethernet port now belongs to the radio, so connect the Pi to your home network over Wi-Fi or with a USB Ethernet adapter. Only the Core's traffic to your apps goes over that connection; it is much lighter than the radio's own data. The radio's data stays on the direct Ethernet cable.
If the Core can see another radio on your home network and no radio has
already been selected, it waits for you to choose one. Pick the cabled radio
in the app under This Core > Change radio, or set its MAC address on the
radio_mac line in /etc/nereusd.conf before starting the Core. A saved
choice made in the app takes precedence over radio_mac.
Optional: turn off Wi-Fi power saving
If the Pi reaches your apps over Wi-Fi, turning off Wi-Fi power saving may smooth out small hiccups. Find the Wi-Fi connection's name:
nmcli -g GENERAL.CONNECTION device show wlan0
Use that name in place of WIFI_CONNECTION. The second command reconnects
Wi-Fi briefly; if you are using SSH over Wi-Fi, reconnect afterward.
sudo nmcli connection modify "WIFI_CONNECTION" 802-11-wireless.powersave 2
sudo nmcli connection up "WIFI_CONNECTION"
This changes the Pi-to-app connection. It does not make Wi-Fi suitable for the radio-to-Core connection.
What has been tested
The direct cable setup was tested with a Raspberry Pi 5 running Raspberry
Pi OS Trixie (64-bit), NetworkManager 1.52.1, and an ANAN-7000DLE/8000DLE using
Protocol 2. The radio took a 169.254 address on its own, and the Core held
the link with no errors after the change.
- Hermes Lite 2 and other radios: direct cable operation has not been tested. A radio configured with a fixed (static) address will not be found by this link-local setup; it needs a matching network configuration.
- Armbian: direct cable operation has not been tested there. Use the Armbian instructions for its networking backend; do not assume the Pi's NetworkManager commands apply.
- Older NetworkManager versions:
fallbackrequires 1.52 or newer. On versions without it,ipv4.method link-localis an alternative for a dedicated cable, but stops the port from using a router's address. That alternative has not been tested here.
For the settings behind these commands, see NetworkManager's IPv4 reference and Wi-Fi power-saving reference.
Direct radio cable on Armbian
Stock Armbian Minimal images for boards such as the Radxa Rock 5C use
Netplan with systemd-networkd. The absence of nmcli is expected on
those images. Armbian CLI and desktop images use NetworkManager instead.
Check the services and find the Ethernet device before choosing the commands:
systemctl is-active systemd-networkd NetworkManager
ip -br link
ls /etc/netplan/
If NetworkManager is active, use the
NetworkManager procedure above, with
your board's connection and device names. Its fallback setting still
requires NetworkManager 1.52 or newer.
For systemd-networkd, keep DHCP enabled and add IPv4 link-local
addressing to the existing Netplan Ethernet definition. That gives the port
a 169.254 address when DHCP cannot obtain one, while retaining DHCP for
a later connection to your LAN.
The standard Armbian Minimal file is
/etc/netplan/10-dhcp-all-interfaces.yaml. If it is present, back it up and
open it:
sudo cp -a /etc/netplan/10-dhcp-all-interfaces.yaml /etc/netplan/10-dhcp-all-interfaces.yaml.bak
sudo nano /etc/netplan/10-dhcp-all-interfaces.yaml
Add link-local: [ipv4, ipv6] under the existing Ethernet definition,
aligned with dhcp4. Keep its other settings. The stock Minimal definition
with that addition looks like this:
network:
version: 2
renderer: networkd
ethernets:
all-eth-interfaces:
match:
name: "e*"
dhcp4: true
dhcp6: true
ipv6-privacy: true
link-local: [ipv4, ipv6]
If your image uses a different file or definition, edit that existing entry. Do not create a second definition that also matches the same port, or overwrite your Wi-Fi or USB Ethernet configuration.
From a local keyboard or the separate Wi-Fi/USB Ethernet connection, test the change:
sudo netplan try
Confirm when prompted if connectivity is correct. If you lose access and cannot confirm, Netplan is intended to roll back the trial. Reconnect and check that the previous configuration has returned before retrying.
With the radio directly cabled, replace ETHERNET_DEVICE with the name
from ip -br link and check for inet 169.254.…/16:
ip -4 address show dev ETHERNET_DEVICE
Keep the radio-to-Core connection wired. Wi-Fi or USB Ethernet connects the board to your apps; the radio's data stays on the direct cable. The radio selection guidance above also applies.
These settings follow the Armbian networking guide, Netplan link-local reference and systemd-networkd IPv4 fallback behavior. Direct radio operation on the Radxa/Armbian setup has not yet been tested.
Troubleshooting and existing installs
Audio plays for a few seconds, then the radio drops, over and over on a direct cable: see Radio plugged directly into the Pi or Direct radio cable on Armbian.
For a startup problem, use sudo systemctl status nereusd and
sudo journalctl -u nereusd -n 50 --no-pager. Existing installs keep their
configuration and private state in /var/lib/nereusd; back that state up to
preserve the Core identity and paired devices. See the
station package/image notes for
build provenance and the separate image workflow.