Go Reticulum Network Stack (RNS)

The Go gopher was designed by Renee French. The design is licensed under the Creative Commons 4.0 Attribution license.
Welcome to the documentation for Go Reticulum, a 100% pure Go rewrite of the Reticulum Network Stack (RNS), the LXMF messaging protocol, and the RRC (Reticulum Relay Chat) ecosystem.
🌐 Live Public Hub & Demo Destinations
A full suite of pure-Go Reticulum daemons runs 24/7 on the public hub. Anyone connected to the mesh or peered via TCP can immediately interact with these live services:
[!TIP]
TCP Bootstrap Interface (
~/.reticulum/config)Add this interface to your
~/.reticulum/configto peer directly with the public hub over TCP:
| Service Daemon | Destination Hash | Protocol / URL | Description |
|---|---|---|---|
| gonomadnet Node | <c7d0e7bbd883e595f53e14fa6986188c> |
nomadnetwork://c7d0e7bbd883e595f53e14fa6986188c |
Live Micron pages served over Reticulum. |
| gorrcd Chat Hub | <a012129c10205c0b9441fcd2b755b2a7> |
rrc://a012129c10205c0b9441fcd2b755b2a7/#general |
Public RRC chat hub. Home of @gobot! |
| gorngit Repos | <58a0406047ec2e7ce23e9e9a83b744df> |
rns://58a0406047ec2e7ce23e9e9a83b744df/<repo> |
Git clone & push over Reticulum mesh links. |
| gorngit Pages | <cb3677a1bb8e37f334096566ed8ff895> |
nomadnetwork://cb3677a1bb8e37f334096566ed8ff895 |
Micron code browser for mesh-hosted repositories. |
| golxmd Propagation | <7acc095f0e83182feb58c888d090a3cc> |
lxmf.propagation |
Store-and-forward LXMF message propagation node. |
What is Reticulum?
Reticulum is a cryptography-first, self-configuring, delay-tolerant networking stack designed to operate over high-latency, low-bandwidth, and unreliable transport media — including LoRa packet radio, HF/VHF/UHF amateur radio, WiFi, Ethernet, TCP/IP, and serial links.
With Reticulum:
- No central authorities, DNS, or IP addresses are required. All destinations are self-sovereign cryptographic keys.
- End-to-end encryption is mandatory and intrinsic. Every packet is signed, authenticated, and encrypted at the stack layer.
- Mesh routing happens autonomously. Nodes discover and announce paths with no manual routing tables needed.
Why Go Reticulum?
The Go port provides a modern, high-performance, single-binary implementation of Reticulum with strict architectural principles:
- Standard Library, Plus One Module: The root module's only external Go dependency is
golang.org/x/sys, for thepoll(2)check that detects a serial port which has hung up, and it uses zero Cgo. All cryptographic primitives (Ed25519, X25519, AES-128, Fernet, SHA-256/512, HKDF) and protocol codecs are implemented natively. - High Concurrency & Low Footprint: Built with Go's lightweight goroutines and channels, providing exceptional throughput and minimal RAM/CPU consumption on low-power devices.
- Drop-In Interoperability: Fully wire-compatible with Python Reticulum, LXMF, and RRC hubs and clients.
- Field-Ready Autonomous Agents: Includes
gorrcbot, an autonomous RRC client and field assistant equipped with offline geodesy, Plus Codes, ephemeris, marine telemetry, wilderness medicine cards, emergency signaling, and an offline cell/repeater finder with built-in WGS-84 ↔ GCJ-02 coordinate conversion for China. Its marine, aviation, navigation, and communications-site catalogs are embedded, sosearch,near, andlistfind an opaque station id with no network at all, and long answers are paginated to the reply budget withmore/next. - Hardware & Firmware Management: Complete device lifecycle tools (
gornodeconf) for flashing, backing up, and provisioning LoRa RNodes on Linux, macOS, and FreeBSD.
Documentation Roadmap
- Getting Started — Installation, initial configuration, and joining the mesh.
- Tools & Daemons — Overview of all included executables:
- gorrcbot — The autonomous RRC chat bot and off-grid field assistant, with offline station discovery (
search,near,list), an offline cell/repeater/cell-tower finder (tower,repeater,cell), and low-bandwidth pagination (more,next). - grb — The Go Reticulum Buddy (GRB) sovereign survival appliance: local stack, sensors, offline field engine, and smartphone captive portal.
- gobot — Ask a live RRC bot one question from the shell and print its reply.
- gorrcd — Standalone high-performance RRC hub daemon.
- golxmd — Standalone LXMF message routing and store-and-forward propagation node.
- gornodeconf — Hardware provisioning and firmware flasher for LoRa RNodes.
- CLI Utilities — Diagnostic and operational commands (
gornstatus,gornpath,gornprobe, etc.).
- gorrcbot — The autonomous RRC chat bot and off-grid field assistant, with offline station discovery (
- Guides — Multi-daemon orchestration, hardware projects, Wasm plugin sandboxing, and radio diagnostics:
- Running a Node — Multi-daemon architecture (
gornsd -s), interactive local launcher, and systemd deployment. - Hardware & LoRa — Building and provisioning LoRa RNode interfaces.
- WebAssembly Plugins — In-process sandboxed Wasm extensions.
- Radio Diagnostics — Real-time telemetry and channel diagnostics.
- Running a Node — Multi-daemon architecture (
- Reference — Certified platform support matrix and cryptographic specifications.