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.
48 commits 1 branch 0 tags 822 KiB
  • Shell 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nickie Deuxyeux fde857ab43 Document all CLI options in --help; restart services by default on non-interactive update 
Add --method and --no-symlinks to help, fix stale --repo-dir default, and add
--restart-services/--no-restart-services. CLI mode now detects an existing
install as an update so running services are restarted without prompting.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-07 01:38:07 +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 Document all CLI options in --help; restart services by default on non-interactive update 2026-10-07 01:38:07 +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)