Install on a Raspberry Pi

The Pi sits next to your radio, connected by the radio's USB cable. You then open a web page from any device. Choose route A (easiest) or route B.

What you need

Route A: the ready-made image (easiest)

The image is Raspberry Pi OS Lite with Radio Remote already installed. It contains no password: you set your own while writing the card.

1. Add the Radio Remote repository to Imager

   Open Raspberry Pi Imager version 2.x. In its application options choose Content Repository, enter a custom repository and paste this address:

   https://github.com/dev-jmatias/YaesuFT991A-Remote/releases/latest/download/os-list.json

2. Choose your Pi and the image

   Pick your Pi model, then Radio Remote for Yaesu in the list of systems. (Do not use Use custom: it skips the personal settings screens.)

3. Fill in Imager's screens

   Choose the SD card, then enter a hostname (for example radio), your user name and password, your Wi-Fi if you do not use a cable, your time zone, and keep SSH enabled. Write the card.

4. Start the Pi

   Put the card in the Pi, connect the radio's USB cable, power on and wait about two minutes.

5. Open the page

   Browse to https://radio.local (use your hostname). Your browser asks once to trust the local certificate. Go on to First run.

Route B: on top of Raspberry Pi OS

1. Write Raspberry Pi OS Lite (64-bit)

   With Imager choose Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit). In the settings screens set hostname, user, password, Wi-Fi and enable SSH. Boot the Pi and wait two minutes.

2. Update the system

   ssh <user>@<hostname>.local
   sudo apt update && sudo apt full-upgrade -y && sudo reboot

3. Download the installer pack

   Get radio-remote-installer-….zip from the Download page and unzip it on your PC.

4. Copy it to the Pi and run it

   scp -r radio-remote-installer <user>@<hostname>.local:~
   ssh <user>@<hostname>.local
   cd radio-remote-installer && sudo bash install-everything.sh

   It installs everything it needs, sets up HTTPS, never opens a firewall port, never enables transmitting and never talks to the radio. Add --dry-run first to see every step without changing anything.

First run (both routes)

1. Create the administrator

   The first visit asks you to create the administrator: use your callsign and a strong password.

2. Choose your radio

   Go to Admin → Config, choose the radio model and the serial port, press Save, then Restart. On the radio, set the CAT rate to 38400 (FT-991A menu 031) and CAT TOT to 100 ms or more (menu 032).

3. Transmitting is off

   Transmitting stays disabled until an administrator switches it on in Admin → Config → Transmitting (PTT) (password required). Test with a dummy load first.

4. Add your people

   Under Admin → Users create a user for everyone who will use the radio and choose their role (viewer, operator, administrator).

Reaching the radio from outside your home

The simplest and safest way is Tailscale: a private network between your devices, with a real HTTPS name and nothing opened on your router.

sudo tailscale up
sudo /opt/radio-remote/current/scripts/tailscale_setup.sh

In the Tailscale admin console switch on MagicDNS and HTTPS Certificates. Then open https://<hostname>.<your-tailnet>.ts.net. More in the Tailscale guide.

Updating

Administrators see a notice in the page when a newer version exists. Press Update now, or on the Pi run sudo /opt/radio-remote/current/scripts/self_update.sh. The update backs up first and rolls back by itself if the new version does not start.