Reticulum CLI Utilities
Go Reticulum provides standard command-line tools for node administration, diagnostics, file transfers, and remote access across the mesh.
gornstatus
Displays the status of local Reticulum network interfaces, traffic volumes, and active routing table entries.
T282828
gornstatus
Options:
• T383838-a, --all: Show detailed interface parameters (frequencies, spreading factors, MTUs).
• T383838-r, --routes: Display complete routing table with known destination hashes and next hops.
• T383838-j, --json: Emit metrics in machine-readable JSON format.
gornpath
Discovers and prints the best known route and hop count to a given destination hash.
T282828
gornpath <destination_hash>
Options:
• T383838-d, --drop: Drop any cached path to the destination and force fresh route discovery.
• T383838-w, --wait <sec>: Maximum time to wait for path discovery announces.
gornprobe
Tests reachability and measures round-trip latency to a destination hash using an encrypted Reticulum probe packet.
T282828
gornprobe <destination_hash>
gornid
Manages 64-byte Reticulum cryptographic identities (Ed25519 / X25519 keypairs).
T282828
# Generate a new identity file
gornid -g ~/.reticulum/my_identity
# Print the identity hash from a private key file
gornid -i ~/.reticulum/my_identity
# Print the destination address for a specific app name
gornid -i ~/.reticulum/my_identity -a "lxmf.delivery"
gorncp
Secure, authenticated file copy across Reticulum links.
T282828
# Send a file to a remote destination
gorncp file.tar.gz <destination_hash>
# Receive files on a local identity
gorncp -l -i ~/.reticulum/my_identity
gornsh
Secure, encrypted remote shell over Reticulum.
T282828
# Connect to an authorized remote server
gornsh <destination_hash>
# Run a listener to accept authorized inbound shell sessions
gornsh -l -i ~/.reticulum/my_identity -a ~/.reticulum/authorized_keys
gorngit
Enables Git operations (T383838git clone, T383838git push, T383838git pull) over the Reticulum mesh via the T383838gogit-remote-rns helper.
T282828
git clone rns://<destination_hash>/repo.git
gornpkg
Offline package manager and distribution utility for sharing software archives, packages, and firmware bundles across Reticulum mesh networks.
T282828
# Publish a package bundle
gornpkg publish my-package.bundle
# Fetch and install a package bundle
gornpkg get <destination_hash>/my-package.bundle
gornsd
The core Reticulum Network Stack transport daemon (Go port of T383838rnsd). It manages physical network interfaces, packet routing, and path tables, and provides a shared instance IPC socket (T383838@rns/default) so that multiple local Reticulum applications (T383838golxmd, T383838gorrcd, T383838gorrcbot, T383838gonomadnet) can coexist without port or interface contention.
T282828
# Run in foreground (desktop testing)
gornsd -v
# Run as background service
gornsd -s
# Print default example configuration
gornsd --exampleconfig > ~/.reticulum/config
Options:
• T383838-s, --service: Run as background service.
• T383838--config <dir>: Path to alternative Reticulum config directory (default: T383838~/.reticulum).
• T383838--exampleconfig: Print annotated example configuration to stdout and exit.
• T383838-v, --verbose: Increase verbosity.
• T383838-q, --quiet: Suppress non-error output.
gornx
Remote command execution over Reticulum (Go port of T383838rnx). Supports authenticated, encrypted remote execution in listen or execution mode.
T282828
# Listen mode: accept authorized remote execution requests
gornx -l -i ~/.reticulum/my_identity
# Execute mode: run command on remote destination
gornx <destination_hash> "uptime" -i ~/.reticulum/my_identity
Options:
• T383838-l: Run in listen mode to accept authorized remote commands.
• T383838-i <path>: Path to identity key file.
• T383838--config <dir>: Path to alternative Reticulum config directory.
• T383838-v, --verbose: Verbose output.
• T383838-q, --quiet: Quiet output.
Authorized caller identity hashes are configured in T383838~/.rnx/allowed_identities or T383838/etc/rnx/allowed_identities.
gornir
Distributed Identity Resolver daemon (Go port of T383838rnir). Discovers and resolves Reticulum destination addresses and identities across the mesh.
T282828
gornir
Options:
• T383838--config <dir>: Path to Reticulum config directory.
• T383838--exampleconfig: Print annotated example configuration.
gorngcs
Git commit signature signer and validator (Go port of T383838rngcs from T383838RNS/Utilities/rngit/commitsigs.py). Produces and verifies SSHSIG-format signatures backed by Reticulum Signed Git (RSG) cryptographic identity envelopes.
T282828
# Sign a commit or file
gorngcs -Y sign -f ~/.reticulum/my_identity -n git commit-message.txt
# Verify a signature
gorngcs -Y verify -s commit-message.txt.sig -f ~/.reticulum/allowed_signers
Options:
• T383838-Y sign: Generate commit signature.
• T383838-Y verify: Verify signature against allowed signers.
• T383838-Y find-principals: List principal identities in signature.
• T383838-Y check-novalidate: Check signature structure without cryptographic validation.
• T383838-f <file>: Key file (signing) or allowed signers file (verifying).
• T383838-s <file>: Signature file to verify.
• T383838-n <namespace>: Verification namespace (e.g. T383838git).
Last updated: 1789730067
This page's visits
c7d0e7bbd883e595f53e14fa6986188c:/page/hit-counter.wasmage=docs/tools/cli-utilities.mu}
Total page views
c7d0e7bbd883e595f53e14fa6986188c:/page/hit-counter.wasm}