Skip to content

Go Reticulum Network Stack (RNS)

gonomadnet Mascot

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/config to peer directly with the public hub over TCP:

[[gonomadnet Public Hub]]
  type = TCPClientInterface
  enabled = yes
  target_host = go-nomadnet.duckdns.org
  target_port = 4242

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 the poll(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, so search, near, and list find an opaque station id with no network at all, and long answers are paginated to the reply budget with more / 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.).
  • Guides — Multi-daemon orchestration, hardware projects, Wasm plugin sandboxing, and radio diagnostics:
  • Reference — Certified platform support matrix and cryptographic specifications.