This repository provides installation, configuration, and uninstallation scripts for deploying Reticulum Network Stack (rnsd) and its messaging router (lxmd) as background services.
The scripts set up services within Python virtual environments running under a dedicated system user.
Choose your operating system to view detailed installation instructions:
- Debian / Ubuntu / Linux Mint (uses
systemdandapt) - Alpine Linux (uses
OpenRCandapk) - NixOS (uses NixOS module and
systemd)
- Isolated: Installs Python packages into a virtual environment at
/opt/reticulum. - Dedicated System User: Services run as the unprivileged
reticulumuser.dialoutaccess is granted for hardware interfaces like RNodes. - Default Configuration: Includes baseline configurations for typical router node setups.
- Testing: Includes Docker-based integration tests.
- SHARED - Running a system-wide Reticulum instance that all users can share
This project is open-source and licensed under the MIT License. You are free to use, modify, and distribute it as you see fit.
AI tools were used to help build this project. Generated code is reviewed by a seasoned developer exercising common sense and practical experience. If you happen to spot any bugs or edge cases, please feel free to open an issue or pull request.