Micron Document
Getting Started with Go Reticulum

This guide covers installing Go Reticulum binaries, generating your first configuration, and verifying stack connectivity.


Installation

Pre-Compiled Binaries

Static, standalone release executables are automatically built and published on the GitHub Releases page for:

Linux (T383838amd64, T383838arm64, T383838armv7, T383838armv6, T383838riscv64)
macOS / Darwin (T383838arm64 Apple Silicon, T383838amd64 Intel)
FreeBSD (T383838amd64, T383838arm64)
Windows (T383838amd64, T383838arm64)

Download the appropriate binary archive for your system, extract it, and place the executables in your T383838$PATH (for example, T383838/usr/local/bin or T383838~/go/bin).

Building from Source

To build from source, ensure you have Go 1.23+ installed:

T282828
git clone https://github.com/gmlewis/go-reticulum.git
cd go-reticulum

# Install all CLI utilities to $GOPATH/bin:
go install ./cmd/go*

To build a specific daemon or tool (for example, T383838gorrcbot or T383838gorrcd):

T282828
go build -o bin/gorrcbot ./cmd/gorrcbot
go build -o bin/gorrcd ./cmd/gorrcd


First Run and Configuration

Reticulum stores its system configuration and identity keys in T383838~/.reticulum/ (or the directory specified by T383838--config).

On first run of any Reticulum tool (such as T383838gornstatus), if no configuration exists, Reticulum creates an initial default configuration file at T383838~/.reticulum/config and generates a primary system identity.

Run T383838gornstatus to verify:

T282828
gornstatus

Output will display the local Reticulum identity hash, uptime, interfaces, and current routing table.

T282828
Shared Instance[0] is running, pid 14280
Primary Interface : AutoInterface[Default Interface]
Interface Status : Up
Received Traffic : 0 bytes
Sent Traffic : 0 bytes


What's Next?

• Configure interfaces and bootstrap mesh connectivity in Bootstrapping Connectivity.
• Orchestrate a full Reticulum node (transport, chat, bot, propagation, web) in Running a Node.
• Learn about the security and pure-Go design in Architecture & Security.
• Explore available tools in Tools Directory.

Last updated: 1789600760

This page's visits
c7d0e7bbd883e595f53e14fa6986188c:/page/hit-counter.wasmage=docs/getting-started/index.mu}
Total page views
c7d0e7bbd883e595f53e14fa6986188c:/page/hit-counter.wasm}