ZRelay SMS Gateway — Stock Phone Setup

Private fleet enrollment for a stock Android phone.

1 · Install the agent APK

  1. On the phone, open Settings → Apps → Special app access → Install unknown apps and allow your browser (e.g. Chrome) to install apps. (On older Android: Settings → Security → Unknown sources.)
  2. Tap Download APK below, then open the downloaded app-release.apk and confirm the install.
  3. Open the SMS Gateway app once and grant the SMS / notification permissions it requests.

Download APK

APK source: registry.blackleafdigital.com/generic/sms-gateway-apk/latest/app-release.apk
The registry is on the private overlay — this download works from a phone that can reach registry.blackleafdigital.com (NetBird or split-horizon DNS).

2 · Scan to enroll

In the SMS Gateway app, open the QR / Configure scanner and point it at this code. It carries the smsgateway://configure deep-link built from this page's URL query parameters.

Deep-link payload

How to populate this page

Open this page with the enrollment fields as query parameters (the same fields scripts/enroll-phone.sh --stock pushes), for example: 

setup-android.blackleafdigital.com/?cloudUrl=https://gateway.blackleafdigital.com&baseUrl=https://relay.blackleafdigital.com&nodeId=NODE_ID&nodeToken=NODE_TOKEN&pushToken=FCM_TOKEN&pairingToken=PAIRING_TOKEN&enableZRelay=true

Recognized params: cloudUrl, baseUrl, nodeId, nodeToken, pushToken, pairingToken, enableZRelay, plus any extra key=value passed through verbatim.