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

Supported Raspberry Pi Models

The iSR Client Debian package targets arm64 (64-bit) Raspberry Pi OS on Pi 3, 4, and 5. Use a 64-bit image for your board; 32-bit (armhf) OS is not supported.

Model Recommended Pi OS Minimum RAM
Raspberry Pi 3 (Model B / B+) Raspberry Pi OS Legacy 64-bit (Bookworm) or OS 11 (Bullseye) 64-bit 2 GB
Raspberry Pi 4 (all variants) Raspberry Pi OS 64-bit (Trixie) or Legacy 64-bit (Bookworm) 2 GB
Raspberry Pi 5 Raspberry Pi OS 64-bit (Trixie) 2 GB

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 runs apt-get upgrade isr-client daily when the iShareRadio APT source is configured

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 install script. It detects your CPU architecture (arm64 on Raspberry Pi), configures the APT repository, and installs isr-client with dependencies.

One-time setup on the Pi:

curl -fsSL https://releases.ishareradio.com/hub2/flex_client/install.sh | sudo bash

The installer enables and starts the isr-client systemd service and the daily APT upgrade timer.

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:8111

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.