deuxyeux/rns-installer
Watch
1
0
Fork
You've already forked rns-installer
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Interactive shell script that installs the Reticulum Network Stack (and optionally LXMF and Nomad Network) via pip, source, or rngit, creating a dedicated system user, virtualenv, and systemd/OpenRC service files.
47 commits 1 branch 0 tags 801 KiB
  • Shell 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nickie Deuxyeux 2a688b55af Add bleak as a required dependency for BLE interface support 
Installed alongside cffi/cryptography in the pip path, and via
dev-python/bleak on Gentoo (emerge build deps, venv-mode hint, and
the generated ebuild's RDEPEND).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-28 17:18:45 +03:00
.gitignore Initial release of rns-installer 2026-05-19 23:23:04 +03:00
README.md Add README with quick-start instructions 2026-05-20 00:20:29 +03:00
rns-installer.sh Add bleak as a required dependency for BLE interface support 2026-09-28 17:18:45 +03:00

README.md

rns-installer

Interactive installer for the Reticulum Network Stack.

Detects your system, checks for existing installations, and walks you through setup with a simple wizard. Supports three installation methods:

  • pip — install from PyPI, no RNS connectivity required (good for first-time bootstrap)
  • source — clone and build directly from the RNS-hosted git repository
  • rngit — fetch pre-built release artifacts over the RNS network

Also handles optional LXMF and Nomad Network installation, creates a dedicated rns system user and virtualenv, writes systemd/OpenRC service files, and creates /usr/local/bin symlinks for all RNS utilities.

Quick start

curl:

curl -fsSL https://git.rns.moscow/deuxyeux/rns-installer/raw/branch/master/rns-installer.sh -o rns-installer.sh
chmod +x rns-installer.sh
./rns-installer.sh

wget:

wget -q https://git.rns.moscow/deuxyeux/rns-installer/raw/branch/master/rns-installer.sh
chmod +x rns-installer.sh
./rns-installer.sh

Run without arguments for the interactive wizard. Pass --help for non-interactive options.

Requirements

  • Bash 4+
  • Python 3.7+
  • pip
  • git (for source/rngit methods)
  • sudo or root (for venv setup and service file installation)