Register your node with GMRS·NET

How presence works

Your node number and its registration password are issued on this site — find both on your dashboard. The node itself does the talking: it checks in on a timer, and the central server considers it ONLINE while the last check-in is younger than the heartbeat TTL.

Check-in interval

60 s

Heartbeat TTL

180 s

IAX2 port

UDP 4569

Miss three check-ins and the directory, world map and your owner alert email all flip you to OFFLINE. There is nothing to un-stick — the next successful check-in brings you straight back.

HTTP registration

The modern path. One JSON POST to /api/register — no SIP stack, no UDP holes, works from behind any NAT.

curl -sS -X POST https://gmrsnet.live/api/register \
  -H 'Content-Type: application/json' \
  -d '{"node": 20001, "secret": "YOUR-NODE-PASSWORD", "port": 4569}'

# 200 {"status":"ok","node":20001,"refresh_seconds":60}

#!/usr/bin/env bash
# /usr/local/bin/gmrsnet-register.sh — keep this node registered
NODE=20001
SECRET="YOUR-NODE-PASSWORD"

while true; do
  curl -sS -m 10 -X POST https://gmrsnet.live/api/register \
    -H 'Content-Type: application/json' \
    -d "{\"node\": $NODE, \"secret\": \"$SECRET\", \"port\": 4569}" \
    >/dev/null || echo "registration failed $(date -u)"
  sleep 60
done

port is optional and is only shown in the directory. Your public IP is taken from the request, so you never have to report it.

Legacy IAX2 (iax.conf)

Already running Asterisk with app_rpt? Point your existing register line at us. The server answers the REGREQ → REGAUTH → REGREQ(md5) → REGACK handshake on UDP 4569, so nothing on your node needs to change beyond the host.

; /etc/asterisk/iax.conf  — legacy app_rpt / Asterisk node
[general]
bindport = 4569
register = 20001:YOUR-NODE-PASSWORD@gmrsnet.live
; register every 60s; the server marks you offline after 180s of silence

Reporting PTT to the live ticker

Add tx to your check-in and your transmissions appear on the home-page ticker and in your node's traffic history.

# key up (PTT pressed)
curl -sS -X POST https://gmrsnet.live/api/register -H 'Content-Type: application/json' \
  -d '{"node":20001,"secret":"YOUR-NODE-PASSWORD","tx":true,"tx_callsign":"WRAA123"}'

# unkey (PTT released) — closes the transmission and records its duration
curl -sS -X POST https://gmrsnet.live/api/register -H 'Content-Type: application/json' \
  -d '{"node":20001,"secret":"YOUR-NODE-PASSWORD","tx":false}'

An open transmission with no update for 180 s is auto-closed, so a node that drops mid-transmission can never stay keyed up forever.

Response codes

Troubleshooting