Any Radio, Any Mode, Anywhere!
openRig is a suite of open source tools for ham radio — from a custom Linux distro for hotspots and remote rigs to full-featured logging and control apps.
A full walkthrough of openRig — from flashing the OS image to getting your hotspot on the air.
Built by hams for hams. openRig focuses on reliability, simplicity, and a modern experience across all your devices.
Run YSF and DMR hotspots on Raspberry Pi hardware with a clean web interface and reflector management. YSF is fully tested; DMR support is in active development.
Control any hamlib-compatible rig over the network. openRigOS turns a Raspberry Pi into a headless CAT controller discoverable via mDNS.
Native apps for macOS, Windows, Linux, iOS, and Android. Log QSOs, watch DX spots, control your rig — all from one place.
A modern gRPC/Connect API on every device. Build your own integrations or use the official apps — the choice is yours.
openRig devices advertise themselves over mDNS. Your apps find them automatically — no IP addresses to remember.
Every line of code is open. Fork it, extend it, contribute back. Licensed under MIT.
Each component works standalone or together as a complete ham radio station stack.
A custom Debian-based Linux distribution for Raspberry Pi and x86 hardware. Supports hotspot, remote rig CAT control, and console workstation roles. Includes a built-in web UI for provisioning and management — no monitor required.
A full-featured desktop logging and rig control application for macOS, Windows, and Linux. Features a three-zone layout with rig control, QSO entry, DX cluster spots, bandmap, and station log.
A native mobile app for iOS and Android. Log contacts, monitor DX spots, control your rig, and manage openRig devices — all from your phone.
The shared Dart library powering both Console and Mobile apps. Includes hamlib FFI bindings, rigctld TCP client, DX cluster client, ADIF read/write, mDNS discovery, DXCC lookup, and more.
Choose what you need — the OS image for your Raspberry Pi hardware, the desktop app for your computer, or both.
Flash to a microSD card and run on your Pi. Supports hotspot, remote rig CAT control, and console roles.
Full-featured desktop logging and rig control app. Log QSOs, watch DX spots, and control your rig.
Linux: build from source — openRigConsole repo, requires Flutter 3.x.
Get openRigOS running on your hardware in minutes.
Download the openRigOS image for your board from the Download section, then flash it to a microSD card with Raspberry Pi Imager using Choose OS → Use custom.
⬇ Go to DownloadsInsert the SD card into your Raspberry Pi and power it on. openRigOS will broadcast a WiFi hotspot named openRig-XXXX on first boot, where XXXX is the last 4 characters of the device's MAC address.
Connect to it, then open http://openrig-config.local in your browser to begin provisioning.
The built-in web wizard walks you through setting your callsign, WiFi, device type (hotspot, remote rig, or console), and any mode-specific settings.
Once provisioned, the management interface is always available at http://<hostname>.local.
Get your MMDVM_HS_Hat hotspot on the air with openRigOS. You can run YSF, DMR, or both — enable whichever modes suit your radio.
Download the Raspberry Pi Zero 2W image from the Get Started section. Open Raspberry Pi Imager, choose Use custom, select the .img.xz file, and flash to your microSD card. No pre-configuration needed.
Seat the MMDVM_HS_Hat on the RPi Zero 2W GPIO header. Attach the UHF antenna. Insert the flashed SD card. Apply power via the USB-C port. The first boot takes about 60 seconds.
On your phone or PC, join the WiFi network openRig-XXXX (password: openrigsetup). Then open http://openrig-config.local in your browser. Alternatively connect via USB cable — the device appears as http://openrig.local.
Fill in the provisioning wizard:
Click Provision Device. The hotspot will connect to your WiFi and restart. Reconnect your computer to your normal WiFi.
Browse to http://<hostname>.local/hotspot (e.g. http://w1aw-hotspot.local/hotspot). On the Hotspot tab, set your RF frequency first, then enable the mode(s) you want:
YSF: Your hotspot links to the selected reflector automatically when the config is saved — no account registration required. You can change or unlink the reflector at any time from the Status tab.
DMR (if enabled): Log in to brandmeister.network → Self Care → Hotspots. Add a hotspot with your DMR ID and set the security password to match what you entered in openRig. The hotspot should connect within a minute.
The Status tab shows live last-heard activity and plots callers on the map. Program your radio to your hotspot frequency, key up, and you should see your callsign appear in the heard list within seconds.
YSF: Set your radio to DN mode, dial in your hotspot frequency, and transmit. DMR: Set time slot 2, colour code 1.
Use a simplex frequency in the 70cm (430–440 MHz) band that is clear of local repeaters. Check your regional band plan. Keep RF power low — hotspots are personal devices for home/portable use.
The full management UI is always at http://<hostname>.local/hotspot. Use the Device tab to back up your config, update credentials, or export settings for a replacement unit.
SSH is always enabled: ssh openrig@<hostname>.local using the password you set during provisioning. Useful for diagnostics and log viewing.