Skip to content

Raspberry Pi Installer

Terms and Privacy

By installing the iSR Client on your computer, you understand and agree to the Terms of Service and Privacy Policy of the iShareRadio platform.

The iSR Client connects devices on your local network to the iShareRadio Hub. Once proxied and paired to an Operator on the Hub, those devices can be controlled, managed, and integrated with alerting and metrics.

Blue: LAN, Green: WAN

The iSR Client can be installed on the same Raspberry Pi as your local hardware, or elsewhere on your network so long as it can reach those devices. The simplest approach is to install it on the Raspberry Pi.

How the Proxy Works

The iSR Client is a secure, intelligent proxy for radios and shack automation on your LAN. It communicates with local devices, understands their configuration, controls switches, relays, and collects readings. The Hub does not directly connect to your local devices and waits for the iSR Client to send status and reading information. The Hub can also send instructions to control and set various features on connected modules.

The Operator must pair the iSR Client first, then pair (add device) each proxied device.

Installing iSR Client on Raspberry Pi

The Debian package installer will perform the following actions:

  1. Install the isr-client executable
  2. Install a systemd service that runs the iSR Client as a service
  3. Install a systemd timer that checks for updates from the iSR Client release server and installs new versions automatically

Requirements: Raspberry Pi OS 64-bit (Debian 13 Trixie — current default), Legacy 64-bit (Debian 12 Bookworm), or OS 11 (Bullseye) on arm64 (Pi 3/4/5 and compatible boards) with Python 3. See Raspberry Pi OS downloads.

Install with apt

Use the iShareRadio APT repository for main-line builds. On a Raspberry Pi, apt selects the arm64 package automatically. Dependencies are resolved by apt, and upgrades use sudo apt upgrade.

One-time setup on the Pi:

curl -fsSL https://releases.ishareradio.com/flex_client/apt/ishareradio-archive-keyring.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/ishareradio.gpg

echo 'deb [signed-by=/usr/share/keyrings/ishareradio.gpg] https://releases.ishareradio.com/flex_client main main' \
  | sudo tee /etc/apt/sources.list.d/ishareradio-flex-client.list

sudo apt update
sudo apt install isr-client

The installer enables and starts the isr-client systemd service and the daily release-updater timer (same as the manual .deb install below).

To upgrade later:

sudo apt update
sudo apt upgrade isr-client

You can check the iSR Client is running by opening its web status page:

http://your-raspberry-pi-ip:8123

Running Console Mode Manually

If you want to run the iSR Client on a headless Linux computer then you can use the --console flag. This is useful for troubleshooting or running the iSR Client on demand. Ensure you have stopped and disabled the systemd iSR Client service beforehand.

sudo service isr-client stop
sudo service isr-client disable

isr-client --console

Logs

For Debian installation the iSR Client will log to $USER/.ishareradio/ when run manually from the console and /var/log/ishareradio/ when run as a systemd service.