HomeGetting Started

Getting Started

Get OpenVARA up and running in under 15 minutes. This guide walks you through installation, radio configuration, and your first VarAC session.

// Prerequisites

Node.js v18 or v20 LTSrequired
ICOM radio with Ethernet (LAN) portrequired
Local network (LAN) connectionrequired
Winlink Express, Pat, or APRS clientoptional
Raspberry Pi 5 (4 GB / 8 GB) — ideal for go-kitsoptional

// Installation Steps

Raspberry Pi 5 recommended for shack & go-kit deployments. The Pi 5 (4 GB or 8 GB) runs OpenVARA with headroom to spare — low power, silent, and fits in any go-kit. Install Raspberry Pi OS (64-bit Lite), then follow the steps below exactly as written. macOS (Intel or Apple Silicon) is also fully supported.
01

Download OpenVARA

Clone the OpenVARA repository from GitHub or download the latest release archive. We recommend cloning so you can easily pull updates.

Terminal
# Clone the repository (source available June 29, 2026)
git clone https://openvara.org/openvara.git
cd openvara

# Or download the latest release from the Downloads page
02

Install Dependencies

Install the required Node.js packages. OpenVARA has no native binary dependencies — it runs on any platform with Node.js v18+.

Terminal
npm install
03

Configure Your Radio

Copy the example configuration and edit it with your radio's IP address and CI-V address. You can find the CI-V address in your radio's menu under SET → Connectors → CI-V Address.

Terminal
cp config/radios.example.json config/radios.json
nano config/radios.json   # or use your preferred editor
config/radios.json
{
  "radios": [
    {
      "id": "radio-1",
      "name": "My IC-7300",
      "model": "IC-7300",
      "host": "192.168.1.100",   ← Your radio's IP
      "port": 50001,
      "civAddress": "0x94",      ← IC-7300 default
      "username": "admin",
      "password": "admin"
    }
  ]
}
04

Start OpenVARA

Start the OpenVARA server. By default it listens on port 3000. Open your browser and navigate to the address shown in the terminal.

Terminal
npm start

# Output:
# ✓ OpenVARA server running at http://localhost:3000
# ✓ Radio 1 (IC-7300) connected — 192.168.1.100:50001
# ✓ VarAC HF modem ready on ports 8300/8301
05

Connect Winlink, Pat, or APRS

With OpenVARA running, configure your Winlink, Pat, or APRS client to use the local VarAC endpoint.

WINLINK EXPRESS / PAT

ModemVARA HF / FM / SAT
Host127.0.0.1
Cmd Port8300
Data Port8301

APRS (built-in)

CallsignYour callsign
SSID0–15
BeaconConfigurable
APRS-ISOptional
06

You're on the Air

OpenVARA is now managing your radio. The web dashboard shows real-time modem status, active sessions, signal reports, and system logs. You can access it from any device on your network.

73 — Welcome to OpenVARA. If you run into issues, check the documentation or ask in the community.