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.
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nickie Deuxyeux 37c4fde7e3 Run rngit OpenRC service as rns:rns instead of root
Add command_user=rns:rns to the generated /etc/init.d/rngit so the
daemon drops privileges to the rns user, and create the pidfile with
rns:rns ownership in start_pre so OpenRC can write it after dropping
root.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-04 13:03:10 +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 Run rngit OpenRC service as rns:rns instead of root 2026-07-04 13:03:10 +03:00

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)