Overview

Runs Reticulum over HF radio using FreeDV data modes.

Quick Start

Flash to SD card using Raspberry Pi Imager
Insert SD card, connect radio via Digirig, power on
Connect to WiFi: ReticulumHF (password: reticulumhf)
Open http://192.168.4.1 in browser
Complete 6-step setup wizard
Connect Sideband to 192.168.4.1:4242

Setup Wizard

Select Radio - Choose from supported radios (tested radios marked)
Radio Settings - Configure your radio with the displayed menu values
Hardware Detection - Automatically detects Digirig, serial port, audio device
Test Connection - Verify CAT and PTT (or check "Using VOX mode" for audio-only)
Network Security - Optional IFAC encryption for the gateway
Start Gateway - Launches services and redirects to status page

IMPORTANT: All stations must use the same FreeDV mode to communicate. Coordinate with other operators before changing modes.

Network Configuration

| Setting | Value | |---------|-------| | WiFi SSID | ReticulumHF | | WiFi Password | reticulumhf | | Gateway IP | 192.168.4.1 | | Web Portal | http://192.168.4.1 | | RNS Gateway Port | 4242 (all clients) | | SSH | pi / reticulumhf |

Client Connections

All clients connect using TCP Client Interface on port 4242.

Sideband / Columba: Settings → Connectivity → Add Interface → TCP Client

| Setting | Value | |---------|-------| | Interface Type | TCP Client Interface | | Address | 192.168.4.1 | | Port | 4242 |

MeshChat: Settings → Interfaces → Add → TCP Client Interface

| Setting | Value | |---------|-------| | Interface Type | TCP Client Interface | | Target Host | 192.168.4.1 | | Target Port | 4242 |

Note: If IFAC is configured on the gateway, clients must use matching IFAC Name and Passphrase.

What's Included

Raspberry Pi OS Bookworm Lite (64-bit)
RNS (Reticulum Network Stack)
freedvtnc2 (FreeDV modem)
codec2 (built from source)
Hamlib rigctld (CAT/PTT control)
Web portal with setup wizard and status dashboard

ReticulumHF

Install / Use

README