2021-05-16 21:40:49 +00:00
<!DOCTYPE html>
< html >
< head >
< meta charset = "utf-8" / >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" / >
2022-06-22 08:08:27 +00:00
< title > Getting Started Fast — Reticulum Network Stack 0.3.8 beta documentation< / title >
2021-05-16 21:40:49 +00:00
< link rel = "stylesheet" type = "text/css" href = "_static/pygments.css" / >
< link rel = "stylesheet" type = "text/css" href = "_static/classic.css" / >
< script data-url_root = "./" id = "documentation_options" src = "_static/documentation_options.js" > < / script >
< script src = "_static/jquery.js" > < / script >
< script src = "_static/underscore.js" > < / script >
< script src = "_static/doctools.js" > < / script >
< link rel = "index" title = "Index" href = "genindex.html" / >
< link rel = "search" title = "Search" href = "search.html" / >
2021-09-25 21:22:33 +00:00
< link rel = "next" title = "Using Reticulum on Your System" href = "using.html" / >
2021-05-16 21:40:49 +00:00
< link rel = "prev" title = "What is Reticulum?" href = "whatis.html" / >
< / head > < body >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
< li class = "right" >
2021-09-25 21:22:33 +00:00
< a href = "using.html" title = "Using Reticulum on Your System"
2021-05-16 21:40:49 +00:00
accesskey="N">next< / a > |< / li >
< li class = "right" >
< a href = "whatis.html" title = "What is Reticulum?"
accesskey="P">previous< / a > |< / li >
2022-06-22 08:08:27 +00:00
< li class = "nav-item nav-item-0" > < a href = "index.html" > Reticulum Network Stack 0.3.8 beta documentation< / a > » < / li >
2021-05-16 21:40:49 +00:00
< li class = "nav-item nav-item-this" > < a href = "" > Getting Started Fast< / a > < / li >
< / ul >
< / div >
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" role = "main" >
< div class = "section" id = "getting-started-fast" >
< h1 > Getting Started Fast< a class = "headerlink" href = "#getting-started-fast" title = "Permalink to this headline" > ¶< / a > < / h1 >
< p > The best way to get started with the Reticulum Network Stack depends on what
you want to do. This guide will outline sensible starting paths for different
scenarios.< / p >
< div class = "section" id = "try-using-a-reticulum-based-program" >
< h2 > Try Using a Reticulum-based Program< a class = "headerlink" href = "#try-using-a-reticulum-based-program" title = "Permalink to this headline" > ¶< / a > < / h2 >
2022-04-28 08:19:43 +00:00
< p > If you simply want to try using a program built with Reticulum, a few different
programs exist that allow basic communication and a range of other useful functions
over even extremely low-bandwidth Reticulum networks.< / p >
< p > These programs will let you get a feel for how Reticulum works. They have been designed
to run well over networks based on LoRa or packet radio, but can also be used completely
over local WiFi, wired ethernet, the Internet, or any combination.< / p >
< p > As such, it is easy to get started experimenting, without having to set up any radio
transceivers or infrastructure just to try it out. Launching the programs on separate
devices connected to the same WiFi network is enough to get started, and physical
radio interfaces can then be added later.< / p >
< div class = "section" id = "nomad-network" >
< h3 > Nomad Network< a class = "headerlink" href = "#nomad-network" title = "Permalink to this headline" > ¶< / a > < / h3 >
< p > The terminal-based program < a class = "reference external" href = "https://github.com/markqvist/nomadnet" > Nomad Network< / a >
provides a complete encrypted communications suite built with Reticulum. It features
encrypted messaging (both direct and delayed-delivery for offline users), file sharing,
and has a built-in text-browser and page server with support for dynamically rendered pages,
user authentication and more.< / p >
2021-09-18 14:29:47 +00:00
< a class = "reference external image-reference" href = "_images/nomadnet_3.png" > < img alt = "_images/nomadnet_3.png" src = "_images/nomadnet_3.png" / > < / a >
2021-05-17 18:01:53 +00:00
< p > < a class = "reference external" href = "https://github.com/markqvist/nomadnet" > Nomad Network< / a > is a user-facing client
2021-12-06 13:10:22 +00:00
for the messaging and information-sharing protocol
2021-05-17 18:01:53 +00:00
< a class = "reference external" href = "https://github.com/markqvist/lxmf" > LXMF< / a > , another project built with Reticulum.< / p >
2021-09-18 14:29:47 +00:00
< p > You can install Nomad Network via pip:< / p >
2021-09-25 19:39:31 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "c1" > # Install ...< / span >
2021-09-18 14:29:47 +00:00
< span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > nomadnet< / span >
2021-09-25 19:39:31 +00:00
< span class = "c1" > # ... and run< / span >
2021-09-18 14:29:47 +00:00
< span class = "n" > nomadnet< / span >
< / pre > < / div >
< / div >
2022-02-22 20:39:16 +00:00
< p > < strong > Please Note< / strong > : If this is the very first time you use pip to install a program
on your system, you might need to reboot your system for your program to become
available. If you get a “command not found” error or similar when running the
program, reboot your system and try again.< / p >
2022-04-28 08:19:43 +00:00
< / div >
< div class = "section" id = "sideband" >
< h3 > Sideband< a class = "headerlink" href = "#sideband" title = "Permalink to this headline" > ¶< / a > < / h3 >
2022-04-07 16:59:42 +00:00
< p > If you would rather use a program with a graphical user interface, you can take
a look at < a class = "reference external" href = "https://unsigned.io/sideband" > Sideband< / a > , which is available for Android,
Linux and macOS.< / p >
< a class = "reference external image-reference" href = "_images/sideband_1.png" > < img alt = "_images/sideband_1.png" class = "align-center" src = "_images/sideband_1.png" style = "width: 400px;" / > < / a >
2022-04-28 08:19:43 +00:00
< p > Sideband is currently in the early stages of development, but already provides basic
communication features, and interoperates with Nomad Network, or any other LXMF client.< / p >
< / div >
2021-05-16 21:40:49 +00:00
< / div >
2021-10-08 16:30:17 +00:00
< div class = "section" id = "using-the-included-utilities" >
< h2 > Using the Included Utilities< a class = "headerlink" href = "#using-the-included-utilities" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Reticulum comes with a range of included utilities that make it easier to
manage your network, check connectivity and make Reticulum available to other
programs on your system.< / p >
< p > You can use < code class = "docutils literal notranslate" > < span class = "pre" > rnsd< / span > < / code > to run Reticulum as a background or foreground service,
and the < code class = "docutils literal notranslate" > < span class = "pre" > rnstatus< / span > < / code > , < code class = "docutils literal notranslate" > < span class = "pre" > rnpath< / span > < / code > and < code class = "docutils literal notranslate" > < span class = "pre" > rnprobe< / span > < / code > utilities to view and query
network status and connectivity.< / p >
< p > To learn more about these utility programs, have a look at the
< a class = "reference internal" href = "using.html#using-main" > < span class = "std std-ref" > Using Reticulum on Your System< / span > < / a > chapter of this manual.< / p >
< / div >
2021-09-25 19:39:31 +00:00
< div class = "section" id = "creating-a-network-with-reticulum" >
< h2 > Creating a Network With Reticulum< a class = "headerlink" href = "#creating-a-network-with-reticulum" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > To create a network, you will need to specify one or more < em > interfaces< / em > for
Reticulum to use. This is done in the Reticulum configuration file, which by
2021-12-06 13:10:22 +00:00
default is located at < code class = "docutils literal notranslate" > < span class = "pre" > ~/.reticulum/config< / span > < / code > . You can edit this file by hand,
or use the interactive < code class = "docutils literal notranslate" > < span class = "pre" > rnsconfig< / span > < / code > utility.< / p >
2021-09-25 19:39:31 +00:00
< p > When Reticulum is started for the first time, it will create a default
configuration file, with one active interface. This default interface uses
2022-04-07 16:59:42 +00:00
your existing ethernet and WiFi networks (if any), and only allows you to
communicate with other Reticulum peers within your local broadcast domains.< / p >
2021-09-25 19:39:31 +00:00
< p > To communicate further, you will have to add one or more interfaces. The default
configuration includes a number of examples, ranging from using TCP over the
internet, to LoRa and Packet Radio interfaces.< / p >
2022-04-07 16:59:42 +00:00
< p > With Reticulum, you only need to configure what interfaces you want to communicate
over. There is no need to configure address spaces, subnets, routing tables,
or other things you might be used to from other network types.< / p >
2022-06-22 13:19:18 +00:00
< p > Once Reticulum knows which interfaces it should use, it will automatically
2022-04-07 16:59:42 +00:00
discover topography and configure transport of data to any destinations it
knows about.< / p >
2022-04-28 08:19:43 +00:00
< p > In situations where you already have an established WiFi or ethernet network, and
2022-06-22 13:19:18 +00:00
many devices that want to utilise the same external Reticulum network paths (for example over
2022-04-28 08:19:43 +00:00
LoRa), it will often be sufficient to let one system act as a Reticulum gateway, by
2022-06-22 13:19:18 +00:00
adding any external interfaces to the configuration of this system, and then enabling transport on it. Any
2022-04-28 08:19:43 +00:00
other device on your local WiFi will then be able to connect to this wider Reticulum
2022-06-22 13:19:18 +00:00
network just using the default (< a class = "reference internal" href = "interfaces.html#interfaces-auto" > < span class = "std std-ref" > AutoInterface< / span > < / a > ) configuration.< / p >
2021-09-25 21:22:33 +00:00
< p > Possibly, the examples in the config file are enough to get you started. If
you want more information, you can read the < a class = "reference internal" href = "networks.html#networks-main" > < span class = "std std-ref" > Building Networks< / span > < / a >
and < a class = "reference internal" href = "interfaces.html#interfaces-main" > < span class = "std std-ref" > Interfaces< / span > < / a > chapters of this manual.< / p >
2021-09-25 19:39:31 +00:00
< / div >
2022-04-07 16:59:42 +00:00
< div class = "section" id = "connecting-reticulum-instances-over-the-internet" >
< h2 > Connecting Reticulum Instances Over the Internet< a class = "headerlink" href = "#connecting-reticulum-instances-over-the-internet" title = "Permalink to this headline" > ¶< / a > < / h2 >
2022-04-28 08:19:43 +00:00
< p > Reticulum currently offers two interfaces suitable for connecting instances over the Internet: < a class = "reference internal" href = "interfaces.html#interfaces-tcps" > < span class = "std std-ref" > TCP< / span > < / a >
2022-04-07 16:59:42 +00:00
and < a class = "reference internal" href = "interfaces.html#interfaces-i2p" > < span class = "std std-ref" > I2P< / span > < / a > . Each interface offers a different set of features, and Reticulum
2022-04-02 08:05:46 +00:00
users should carefully choose the interface which best suites their needs.< / p >
2022-04-07 16:59:42 +00:00
< p > The < code class = "docutils literal notranslate" > < span class = "pre" > TCPServerInterface< / span > < / code > allows users to host an instance accessible over TCP/IP. This
2022-04-02 08:05:46 +00:00
method is generally faster, lower latency, and more energy efficient than using < code class = "docutils literal notranslate" > < span class = "pre" > I2PInterface< / span > < / code > ,
2022-04-28 08:19:43 +00:00
however it also leaks more data about the server host.< / p >
< p > TCP connections reveal the IP address of both your instance and the server to anyone who can
inspect the connection. Someone could use this information to determine your location or identity. Adversaries
2022-04-07 18:15:35 +00:00
inspecting your packets may be able to record packet metadata like time of transmission and packet size.
Even though Reticulum encrypts traffic, TCP does not, so an adversary may be able to use
packet inspection to learn that a system is running Reticulum, and what other IP adresses connect to it.
Hosting a publicly reachable instance over TCP also requires a publicly reachable IP address,
which most Internet connections don’ < / p >
2022-04-02 08:05:46 +00:00
< p > The < code class = "docutils literal notranslate" > < span class = "pre" > I2PInterface< / span > < / code > routes messages through the < a class = "reference external" href = "https://geti2p.net/en/" > Invisible Internet Protocol
2022-06-22 13:19:18 +00:00
(I2P)< / a > . To use this interface, users must also run an I2P daemon in
2022-04-28 08:19:43 +00:00
parallel to < code class = "docutils literal notranslate" > < span class = "pre" > rnsd< / span > < / code > . For always-on I2P nodes it is recommended to use < a class = "reference external" href = "https://i2pd.website/" > i2pd< / a > .< / p >
< p > By default, I2P will encrypt and mix all traffic sent over the Internet, and
2022-04-07 18:15:35 +00:00
hide both the sender and receiver Reticulum instance IP addresses. Running an I2P node
2022-04-02 08:05:46 +00:00
will also relay other I2P user’
bandwidth and compute power, but also makes timing attacks and other forms of
2022-04-07 18:15:35 +00:00
deep-packet-inspection much more difficult.< / p >
2022-06-22 13:19:18 +00:00
< p > I2P also allows users to host globally available Reticulum instances from non-public IPs and behind firewalls and NAT.< / p >
2022-04-07 16:59:42 +00:00
< p > In general it is recommended to use an I2P node if you want to host a publically accessible
instance, while preserving anonymity. If you care more about performance, and a slightly
easier setup, use TCP.< / p >
2022-04-07 18:15:35 +00:00
< / div >
< div class = "section" id = "connect-to-the-public-testnet" >
< h2 > Connect to the Public Testnet< a class = "headerlink" href = "#connect-to-the-public-testnet" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > An experimental public testnet has been made accessible over both I2P and TCP. You can join it
by adding one of the following interfaces to your < code class = "docutils literal notranslate" > < span class = "pre" > .reticulum/config< / span > < / code > file:< / p >
2022-04-02 08:05:46 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "c1" > # For connecting over TCP/IP:< / span >
< span class = "p" > [[< / span > < span class = "n" > RNS< / span > < span class = "n" > Testnet< / span > < span class = "n" > Frankfurt< / span > < span class = "p" > ]]< / span >
< span class = "nb" > type< / span > < span class = "o" > =< / span > < span class = "n" > TCPClientInterface< / span >
< span class = "n" > interface_enabled< / span > < span class = "o" > =< / span > < span class = "n" > yes< / span >
< span class = "n" > outgoing< / span > < span class = "o" > =< / span > < span class = "kc" > True< / span >
< span class = "n" > target_host< / span > < span class = "o" > =< / span > < span class = "n" > frankfurt< / span > < span class = "o" > .< / span > < span class = "n" > rns< / span > < span class = "o" > .< / span > < span class = "n" > unsigned< / span > < span class = "o" > .< / span > < span class = "n" > io< / span >
< span class = "n" > target_port< / span > < span class = "o" > =< / span > < span class = "mi" > 4965< / span >
< span class = "c1" > # For connecting over I2P:< / span >
< span class = "p" > [[< / span > < span class = "n" > RNS< / span > < span class = "n" > Testnet< / span > < span class = "n" > I2P< / span > < span class = "n" > Node< / span > < span class = "n" > A< / span > < span class = "p" > ]]< / span >
< span class = "nb" > type< / span > < span class = "o" > =< / span > < span class = "n" > I2PInterface< / span >
< span class = "n" > interface_enabled< / span > < span class = "o" > =< / span > < span class = "n" > yes< / span >
< span class = "n" > peers< / span > < span class = "o" > =< / span > < span class = "n" > ykzlw5ujbaqc2xkec4cpvgyxj257wcrmmgkuxqmqcur7cq3w3lha< / span > < span class = "o" > .< / span > < span class = "n" > b32< / span > < span class = "o" > .< / span > < span class = "n" > i2p< / span >
< / pre > < / div >
< / div >
2022-04-07 18:15:35 +00:00
< p > Many other Reticulum instances are connecting to this testnet, and you can also join it
via other entry points if you know them. There is absolutely no control over the network
topography, usage or what types of instances connect. It will also occasionally be used
to test various failure scenarios, and there are no availability or service guarantees.< / p >
2022-04-02 08:05:46 +00:00
< / div >
2022-06-22 13:19:18 +00:00
< div class = "section" id = "adding-radio-interfaces" >
< h2 > Adding Radio Interfaces< a class = "headerlink" href = "#adding-radio-interfaces" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Once you have Reticulum installed and working, you can add radio interfaces with
any compatible hardware you have available. Reticulum supports a wide range of radio
hardware, and if you already have any available, it is very likely that it will
work with Reticulum. For information on how to configure this, see the
< a class = "reference internal" href = "interfaces.html#interfaces-main" > < span class = "std std-ref" > Interfaces< / span > < / a > section of this manual.< / p >
< p > If you do not already have transceiver hardware available, you can easily and
cheaply build an < a class = "reference internal" href = "hardware.html#rnode-main" > < span class = "std std-ref" > RNode< / span > < / a > , which is a general-purpose long-range
digital radio transceiver, that integrates easily with Reticulum.< / p >
< p > To build one yourself requires installing a custom firmware on a supported LoRa
development board with an auto-install script. Please see the < a class = "reference internal" href = "hardware.html#hardware-main" > < span class = "std std-ref" > Communications Hardware< / span > < / a >
chapter for a guide. If you prefer purchasing a ready-made unit, you can refer to the
< a class = "reference internal" href = "hardware.html#rnode-suppliers" > < span class = "std std-ref" > list of suppliers< / span > < / a > . For more information on RNode, you can also
refer to these additional external resources:< / p >
< ul class = "simple" >
< li > < p > < a class = "reference external" href = "https://unsigned.io/how-to-make-your-own-rnodes/" > How To Make Your Own RNodes< / a > < / p > < / li >
< li > < p > < a class = "reference external" href = "https://unsigned.io/installing-rnode-firmware-on-t-beam-and-lora32-devices/" > Installing RNode Firmware on Compatible LoRa Devices< / a > < / p > < / li >
< li > < p > < a class = "reference external" href = "https://unsigned.io/private-messaging-over-lora/" > Private, Secure and Uncensorable Messaging Over a LoRa Mesh< / a > < / p > < / li >
< li > < p > < a class = "reference external" href = "https://github.com/markqvist/RNode_Firmware/" > RNode Firmware< / a > < / p > < / li >
< / ul >
< p > If you have communications hardware that is not already supported by any of the
< a class = "reference internal" href = "interfaces.html#interfaces-main" > < span class = "std std-ref" > existing interface types< / span > < / a > , but you think would be suitable for use with Reticulum,
you are welcome to head over to the < a class = "reference external" href = "https://github.com/markqvist/Reticulum/discussions" > GitHub discussion pages< / a >
and propose adding an interface for the hardware.< / p >
< / div >
2021-05-16 21:40:49 +00:00
< div class = "section" id = "develop-a-program-with-reticulum" >
< h2 > Develop a Program with Reticulum< a class = "headerlink" href = "#develop-a-program-with-reticulum" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > If you want to develop programs that use Reticulum, the easiest way to get
2021-05-20 14:06:12 +00:00
started is to install the latest release of Reticulum via pip:< / p >
2021-05-16 21:40:49 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > rns< / span >
< / pre > < / div >
< / div >
< p > The above command will install Reticulum and dependencies, and you will be
ready to import and use RNS in your own programs. The next step will most
likely be to look at some < a class = "reference internal" href = "examples.html#examples-main" > < span class = "std std-ref" > Example Programs< / span > < / a > .< / p >
2021-12-02 17:33:00 +00:00
< p > For extended functionality, you can install optional dependencies:< / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > pyserial< / span > < span class = "n" > netifaces< / span >
< / pre > < / div >
< / div >
2021-05-16 21:40:49 +00:00
< p > Further information can be found in the < a class = "reference internal" href = "reference.html#api-main" > < span class = "std std-ref" > API Reference< / span > < / a > .< / p >
< / div >
< div class = "section" id = "participate-in-reticulum-development" >
< h2 > Participate in Reticulum Development< a class = "headerlink" href = "#participate-in-reticulum-development" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > If you want to participate in the development of Reticulum and associated
utilities, you’
don’ < / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "c1" > # Install dependencies< / span >
2021-09-25 19:39:31 +00:00
< span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > cryptography< / span > < span class = "n" > pyserial< / span > < span class = "n" > netifaces< / span >
2021-05-16 21:40:49 +00:00
< span class = "c1" > # Clone repository< / span >
< span class = "n" > git< / span > < span class = "n" > clone< / span > < span class = "n" > https< / span > < span class = "p" > :< / span > < span class = "o" > //< / span > < span class = "n" > github< / span > < span class = "o" > .< / span > < span class = "n" > com< / span > < span class = "o" > /< / span > < span class = "n" > markqvist< / span > < span class = "o" > /< / span > < span class = "n" > Reticulum< / span > < span class = "o" > .< / span > < span class = "n" > git< / span >
< span class = "c1" > # Move into Reticulum folder and symlink library to examples folder< / span >
< span class = "n" > cd< / span > < span class = "n" > Reticulum< / span >
< span class = "n" > ln< / span > < span class = "o" > -< / span > < span class = "n" > s< / span > < span class = "o" > ../< / span > < span class = "n" > RNS< / span > < span class = "o" > ./< / span > < span class = "n" > Examples< / span > < span class = "o" > /< / span >
< span class = "c1" > # Run an example< / span >
< span class = "n" > python3< / span > < span class = "n" > Examples< / span > < span class = "o" > /< / span > < span class = "n" > Echo< / span > < span class = "o" > .< / span > < span class = "n" > py< / span > < span class = "o" > -< / span > < span class = "n" > s< / span >
< span class = "c1" > # Unless you' ve manually created a config file, Reticulum will do so now,< / span >
< span class = "c1" > # and immediately exit. Make any necessary changes to the file:< / span >
< span class = "n" > nano< / span > < span class = "o" > ~/.< / span > < span class = "n" > reticulum< / span > < span class = "o" > /< / span > < span class = "n" > config< / span >
< span class = "c1" > # ... and launch the example again.< / span >
< span class = "n" > python3< / span > < span class = "n" > Examples< / span > < span class = "o" > /< / span > < span class = "n" > Echo< / span > < span class = "o" > .< / span > < span class = "n" > py< / span > < span class = "o" > -< / span > < span class = "n" > s< / span >
< span class = "c1" > # You can now repeat the process on another computer,< / span >
< span class = "c1" > # and run the same example with -h to get command line options.< / span >
< span class = "n" > python3< / span > < span class = "n" > Examples< / span > < span class = "o" > /< / span > < span class = "n" > Echo< / span > < span class = "o" > .< / span > < span class = "n" > py< / span > < span class = "o" > -< / span > < span class = "n" > h< / span >
< span class = "c1" > # Run the example in client mode to " ping" the server.< / span >
< span class = "c1" > # Replace the hash below with the actual destination hash of your server.< / span >
< span class = "n" > python3< / span > < span class = "n" > Examples< / span > < span class = "o" > /< / span > < span class = "n" > Echo< / span > < span class = "o" > .< / span > < span class = "n" > py< / span > < span class = "mf" > 3e12< / span > < span class = "n" > fc71692f8ec47bc5< / span >
< span class = "c1" > # Have a look at another example< / span >
< span class = "n" > python3< / span > < span class = "n" > Examples< / span > < span class = "o" > /< / span > < span class = "n" > Filetransfer< / span > < span class = "o" > .< / span > < span class = "n" > py< / span > < span class = "o" > -< / span > < span class = "n" > h< / span >
< / pre > < / div >
< / div >
< p > When you have experimented with the basic examples, it’
< a class = "reference internal" href = "understanding.html#understanding-main" > < span class = "std std-ref" > Understanding Reticulum< / span > < / a > chapter.< / p >
< / div >
2021-12-09 17:12:18 +00:00
< div class = "section" id = "reticulum-on-arm64" >
< h2 > Reticulum on ARM64< a class = "headerlink" href = "#reticulum-on-arm64" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > On some architectures, including ARM64, not all dependencies have precompiled
binaries. On such systems, you will need to install < code class = "docutils literal notranslate" > < span class = "pre" > python3-dev< / span > < / code > before
installing Reticulum or programs that depend on Reticulum.< / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "c1" > # Install Python and development packages< / span >
< span class = "n" > sudo< / span > < span class = "n" > apt< / span > < span class = "n" > update< / span >
< span class = "n" > sudo< / span > < span class = "n" > apt< / span > < span class = "n" > install< / span > < span class = "n" > python3< / span > < span class = "n" > python3< / span > < span class = "o" > -< / span > < span class = "n" > pip< / span > < span class = "n" > python3< / span > < span class = "o" > -< / span > < span class = "n" > dev< / span >
< span class = "c1" > # Install Reticulum< / span >
< span class = "n" > python3< / span > < span class = "o" > -< / span > < span class = "n" > m< / span > < span class = "n" > pip< / span > < span class = "n" > install< / span > < span class = "n" > rns< / span >
< / pre > < / div >
< / div >
< / div >
2021-12-05 22:24:30 +00:00
< div class = "section" id = "reticulum-on-android" >
< h2 > Reticulum on Android< a class = "headerlink" href = "#reticulum-on-android" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Reticulum can be used on Android in different ways. The easiest way to get
2022-04-07 16:59:42 +00:00
started is using an app like < a class = "reference external" href = "https://unsigned.io/sideband" > Sideband< / a > .< / p >
< p > For more control and features, you can use Reticulum and related programs via
the < a class = "reference external" href = "https://termux.com/" > Termux app< / a > , at the time of writing available on
< a class = "reference external" href = "https://f-droid.org" > F-droid< / a > .< / p >
2021-12-05 22:31:01 +00:00
< p > Termux is a terminal emulator and Linux environment for Android based devices,
which includes the ability to use many different programs and libraries,
including Reticulum.< / p >
2021-12-05 22:24:30 +00:00
< p > Since the Python cryptography.io module does not offer pre-built wheels for
Android, the standard one-line install of Reticulum does not work on Android,
and a few extra commands are required.< / p >
< p > From within Termux, execute the following:< / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "c1" > # First, make sure indexes and packages are up to date.< / span >
< span class = "n" > pkg< / span > < span class = "n" > update< / span >
< span class = "n" > pkg< / span > < span class = "n" > upgrade< / span >
2021-12-06 13:10:22 +00:00
< span class = "c1" > # Then install dependencies for the cryptography library.< / span >
2021-12-05 22:24:30 +00:00
< span class = "n" > pkg< / span > < span class = "n" > install< / span > < span class = "n" > python< / span > < span class = "n" > build< / span > < span class = "o" > -< / span > < span class = "n" > essential< / span > < span class = "n" > openssl< / span > < span class = "n" > libffi< / span > < span class = "n" > rust< / span >
2021-12-05 22:31:01 +00:00
< span class = "c1" > # Make sure pip is up to date, and install the wheel module.< / span >
2021-12-05 22:24:30 +00:00
< span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > wheel< / span > < span class = "n" > pip< / span > < span class = "o" > --< / span > < span class = "n" > upgrade< / span >
2021-12-09 17:53:28 +00:00
< span class = "c1" > # To allow the installer to build the cryptography module,< / span >
< span class = "c1" > # we need to let it know what platform we are compiling for:< / span >
< span class = "n" > export< / span > < span class = "n" > CARGO_BUILD_TARGET< / span > < span class = "o" > =< / span > < span class = "s2" > " aarch64-linux-android" < / span >
2021-12-05 22:24:30 +00:00
< span class = "c1" > # Start the install process for the cryptography module.< / span >
< span class = "c1" > # Depending on your device, this can take several minutes,< / span >
< span class = "c1" > # since the module must be compiled locally on your device.< / span >
< span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > cryptography< / span >
< span class = "c1" > # If the above installation succeeds, you can now install< / span >
< span class = "c1" > # Reticulum and any related software< / span >
< span class = "n" > pip3< / span > < span class = "n" > install< / span > < span class = "n" > rns< / span >
< / pre > < / div >
< / div >
< p > It is also possible to include Reticulum in apps compiled and distributed as
Android APKs. A detailed tutorial and example source code will be included
here at a later point.< / p >
< / div >
2022-06-22 13:19:18 +00:00
< div class = "section" id = "pure-python-reticulum" >
< h2 > Pure-Python Reticulum< a class = "headerlink" href = "#pure-python-reticulum" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > In some rare cases, and on more obscure system types, it is not possible to
install one or more dependencies< / p >
< p > On more unusual systems, and in some rare cases, it might not be possible to
install or even compile one or more of the above modules. In such situations,
you can use the < code class = "docutils literal notranslate" > < span class = "pre" > rnspure< / span > < / code > package instead of the < code class = "docutils literal notranslate" > < span class = "pre" > rns< / span > < / code > package. The < code class = "docutils literal notranslate" > < span class = "pre" > rnspure< / span > < / code >
package requires no external dependencies for installation. Please note that the
actual contents of the < code class = "docutils literal notranslate" > < span class = "pre" > rns< / span > < / code > and < code class = "docutils literal notranslate" > < span class = "pre" > rnspure< / span > < / code > packages are < em > completely identical< / em > .
The only difference is that the < code class = "docutils literal notranslate" > < span class = "pre" > rnspure< / span > < / code > package lists no dependencies required
for installation.< / p >
< p > No matter how Reticulum is installed and started, it will load external dependencies
only if they are < em > needed< / em > and < em > available< / em > . If for example you want to use Reticulum
on a system that cannot support < code class = "docutils literal notranslate" > < span class = "pre" > pyserial< / span > < / code > , it is perfectly possible to do so using
the < cite > rnspure< / cite > package, but Reticulum will not be able to use serial-based interfaces.
All other available modules will still be loaded when needed.< / p >
< p > < strong > Please Note!< / strong > If you use the < cite > rnspure< / cite > package to run Reticulum on systems that
do not support < a class = "reference external" href = "https://github.com/pyca/cryptography" > PyCA/cryptography< / a > , it is
important that you read and understand the < a class = "reference internal" href = "understanding.html#understanding-primitives" > < span class = "std std-ref" > Cryptographic Primitives< / span > < / a >
section of this manual.< / p >
2022-04-07 16:59:42 +00:00
< / div >
2021-05-16 21:40:49 +00:00
< / div >
< div class = "clearer" > < / div >
< / div >
< / div >
< / div >
< div class = "sphinxsidebar" role = "navigation" aria-label = "main navigation" >
< div class = "sphinxsidebarwrapper" >
< h3 > < a href = "index.html" > Table of Contents< / a > < / h3 >
< ul >
< li > < a class = "reference internal" href = "#" > Getting Started Fast< / a > < ul >
2022-04-28 08:19:43 +00:00
< li > < a class = "reference internal" href = "#try-using-a-reticulum-based-program" > Try Using a Reticulum-based Program< / a > < ul >
< li > < a class = "reference internal" href = "#nomad-network" > Nomad Network< / a > < / li >
< li > < a class = "reference internal" href = "#sideband" > Sideband< / a > < / li >
< / ul >
< / li >
2021-10-08 16:30:17 +00:00
< li > < a class = "reference internal" href = "#using-the-included-utilities" > Using the Included Utilities< / a > < / li >
2021-09-25 19:39:31 +00:00
< li > < a class = "reference internal" href = "#creating-a-network-with-reticulum" > Creating a Network With Reticulum< / a > < / li >
2022-04-07 16:59:42 +00:00
< li > < a class = "reference internal" href = "#connecting-reticulum-instances-over-the-internet" > Connecting Reticulum Instances Over the Internet< / a > < / li >
2022-04-07 18:15:35 +00:00
< li > < a class = "reference internal" href = "#connect-to-the-public-testnet" > Connect to the Public Testnet< / a > < / li >
2022-06-22 13:19:18 +00:00
< li > < a class = "reference internal" href = "#adding-radio-interfaces" > Adding Radio Interfaces< / a > < / li >
2021-05-16 21:40:49 +00:00
< li > < a class = "reference internal" href = "#develop-a-program-with-reticulum" > Develop a Program with Reticulum< / a > < / li >
< li > < a class = "reference internal" href = "#participate-in-reticulum-development" > Participate in Reticulum Development< / a > < / li >
2021-12-09 17:12:18 +00:00
< li > < a class = "reference internal" href = "#reticulum-on-arm64" > Reticulum on ARM64< / a > < / li >
2021-12-05 22:24:30 +00:00
< li > < a class = "reference internal" href = "#reticulum-on-android" > Reticulum on Android< / a > < / li >
2022-06-22 13:19:18 +00:00
< li > < a class = "reference internal" href = "#pure-python-reticulum" > Pure-Python Reticulum< / a > < / li >
2021-05-16 21:40:49 +00:00
< / ul >
< / li >
< / ul >
< h4 > Previous topic< / h4 >
< p class = "topless" > < a href = "whatis.html"
title="previous chapter">What is Reticulum?< / a > < / p >
< h4 > Next topic< / h4 >
2021-09-25 21:22:33 +00:00
< p class = "topless" > < a href = "using.html"
title="next chapter">Using Reticulum on Your System< / a > < / p >
2021-05-16 21:40:49 +00:00
< div role = "note" aria-label = "source link" >
< h3 > This Page< / h3 >
< ul class = "this-page-menu" >
< li > < a href = "_sources/gettingstartedfast.rst.txt"
rel="nofollow">Show Source< / a > < / li >
< / ul >
< / div >
< div id = "searchbox" style = "display: none" role = "search" >
< h3 id = "searchlabel" > Quick search< / h3 >
< div class = "searchformwrapper" >
< form class = "search" action = "search.html" method = "get" >
< input type = "text" name = "q" aria-labelledby = "searchlabel" / >
< input type = "submit" value = "Go" / >
< / form >
< / div >
< / div >
< script > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "genindex.html" title = "General Index"
>index< / a > < / li >
< li class = "right" >
2021-09-25 21:22:33 +00:00
< a href = "using.html" title = "Using Reticulum on Your System"
2021-05-16 21:40:49 +00:00
>next< / a > |< / li >
< li class = "right" >
< a href = "whatis.html" title = "What is Reticulum?"
>previous< / a > |< / li >
2022-06-22 08:08:27 +00:00
< li class = "nav-item nav-item-0" > < a href = "index.html" > Reticulum Network Stack 0.3.8 beta documentation< / a > » < / li >
2021-05-16 21:40:49 +00:00
< li class = "nav-item nav-item-this" > < a href = "" > Getting Started Fast< / a > < / li >
< / ul >
< / div >
< div class = "footer" role = "contentinfo" >
2022-05-13 18:19:54 +00:00
© Copyright 2022, Mark Qvist.
2021-05-16 21:40:49 +00:00
Created using < a href = "https://www.sphinx-doc.org/" > Sphinx< / a > 4.0.1.
< / div >
< / body >
< / html >
