RingQ Customer Centric Communications

Raspberry Pi Install Guide

Secure Tunnel Client — Raspberry Pi (SBC) Installation Guide

Flash Raspberry Pi OS onto a microSD card using Raspberry Pi Imager. For a device that will run headless as a tunnel client, the Lite image is enough — no desktop environment needed.

  • Download and open Raspberry Pi Imager (raspberrypi.com/software) on your computer.
  • Choose Raspberry Pi OS Lite (64-bit) as the OS.
  • Select the target microSD card.
  • Before writing, click the gear/settings icon (or press Ctrl+Shift+X) to open advanced options:
    • Enable SSH, and set a username/password.
    • Configure Wi-Fi credentials if not using Ethernet.
    • Set the hostname (e.g. ringq-tunnel) so it’s easy to find on the network.
  • Write the image, then insert the card into the Raspberry Pi and power it on.

ℹ Enabling SSH and Wi-Fi during imaging avoids connecting a keyboard/monitor — the Pi can be set up completely headless.

2. First Boot & SSH Access

Give the Pi a minute to boot, then connect to it from your computer over SSH.

# Using the hostname set during imaging

ssh pi@ringq-tunnel.local

# Or using its IP address directly (find it from your router's client list)

ssh pi@<pi-ip-address>

Accept the host key prompt on first connection, then log in with the password set in Raspberry Pi Imager.

3. Update the OS

Bring the Pi’s packages up to date before installing the tunnel client.

sudo apt update

sudo apt upgrade -y

4. Install the Secure Tunnel Client

Raspberry Pi OS is Debian-based, so the same installer used on other Linux devices runs here as well.

curl -fsSL https://raw.githubusercontent.com/Cal4Care-Developers/proxytunnel/master/install.sh -o /tmp/install.sh

chmod +x /tmp/install.sh

sudo /tmp/install.sh

Follow the same prompts as a standard Linux install (PBX domain, auth-key). The same flags apply if you need to re-run it:

  • sudo /tmp/install.sh --yes — re-run after a partial failure.
  • sudo /tmp/install.sh --reconfigure — change the PBX domain or auth-key.
  • sudo /tmp/install.sh --reinstall — force re-download of Go and re-clone the repo.

💡 The Raspberry Pi’s ARM processor is a different architecture from a typical x86 server. If the installer reports a missing or incompatible Go build, confirm an ARM64 build is available before re-running.

5. Verify the Tunnel

Once installation finishes, confirm the tunnel is up and connected.

# one-shot status

ringqtunnel-status

# live service log, if status looks wrong

journalctl -u ringqproxy -f