Kom igång med Reticulum¶

Det enklaste sättet att förstå Reticulum är att först få två enheter att skicka ett meddelande till varandra. Börja utan LoRa. När grunderna fungerar kan du lägga till radio och andra länkar senare.

Den här guiden använder Columba, en grafisk meddelandeapp som körs ovanpå Reticulum och LXMF.

Reticulumprojektets "officiella" app, skapad av skaparen av Reticulum, heter Sideband och kan hittas här https://reticulum.network/manual/software.html#sideband men är tyvärr inte särskilt användarvänlig, därav att vi här väljer Columba i vår guide.

Det här behöver du¶

Du behöver två installationer av Columba, exempelvis:

• en telefon och en dator
• två telefoner
• två datorer

För det första testet bör båda enheterna kunna ansluta till samma vanliga Wi-Fi-nät.

1. Installera Columba¶

Hämta Columba från projektets senaste utgåva eller följ installationsinformationen i Columbas projektbeskrivning.

På Android kan appen installeras från en APK, detta kan automatisk hållas uppdaterat med t.ex. Obtanium (se länk och instruktioner i instruktionslänken ovan).

2. Säkerhetskopiera identiteten¶

Identiteten avgör vem du är för dina kontakter. Om den försvinner går det inte att återskapa samma privata nycklar genom att bara välja samma namn igen.

Använd därför appens funktion för att exportera eller säkerhetskopiera identiteten innan du börjar använda den för viktig kommunikation. Förvara säkerhetskopian separat och skyddat.

3. Börja på samma lokala nätverk¶

Anslut båda enheterna till samma vanliga Wi-Fi-nät och låt lokal Reticulum-anslutning vara aktiverad.

Reticulums AutoInterface kan upptäcka andra Reticulum-enheter på samma lokala nät utan att du behöver skapa IP-adresser eller routingtabeller för Reticulum.

4. Skicka en announce¶

Låt båda apparna tala om att deras meddelandedestination finns genom att skicka en announce. Funktionen kan heta exempelvis Announce, Send Announce eller liknande beroende på version.

Öppna sedan flödet med mottagna announces på den andra enheten. Där bör den första enheten dyka upp efter en stund.

5. Lägg till kontakten och skicka ett meddelande¶

Öppna den mottagna annonsen, lägg till destinationen som kontakt och skicka ett kort testmeddelande.

Gör därefter samma sak åt andra hållet. Då vet du att:

• båda enheterna kan upptäcka nätet
• identiteterna fungerar
• LXMF kan leverera meddelanden
• den lokala transportvägen fungerar

6. Testa mellan olika nätverk¶

Två enheter på olika internetanslutningar hittar inte automatiskt varandra bara för att båda har Columba installerat.

För att nå längre behöver båda ha en väg in i samma eller sammankopplade Reticulum-nät. Det kan vara:

• en gemensam publik TCP-nod
• en egen transportnod
• en I2P-anslutning
• en radio- eller annan fysisk länk som binder ihop näten

Columba kan erbjuda en enkel TCP-anslutning för att prova bredare anslutning. Se den som en startpunkt, inte som ett krav för hur ett eget Reticulum-nät måste byggas.

Om enheterna inte hittar varandra¶

Kontrollera följande:

• båda apparna körs och har lokal anslutning aktiverad
• båda enheterna är på samma lokala nät
• nätet tillåter trafik direkt mellan klienter
• brandväggen tillåter Reticulums lokala UDP-trafik
• båda enheterna använder samma gruppinställning för sitt lokala interface
• enheterna har skickat en announce efter att anslutningen startade

Reticulums AutoInterface använder normalt UDP-portarna 29716 och 42671. Du behöver bara öppna dem i brandväggen för det lokala nätet, inte publicera dem mot internet.

Vad du bör kunna efter testet¶

När du har fått ett lokalt meddelande att fungera bör du känna igen följande:

• Columba är appen, inte själva nätverkslagret
• en identity är din kryptografiska identitet
• en destination är adressen till en funktion i en app
• en announce hjälper andra att hitta destinationen
• ett interface är vägen som trafiken färdas över

våra favoritapplikationer idag:¶

Android: Columba - meddelande (LMXF) och telefon-via-reticulum (LXST) applikation för bruk på Android. Bästa Androidklienten enligt oss (som snart även får stöd för att besöka NomadNet-sidor!) Sideband - Officiella applikationen för Android. Bra men relativt icke-användarvänlig.

Windows: MeshChatX - LMXF, LXST, Nomadnet, RRC-klient, allt i ett. Kan även hosta några av tjänsterna och agera t.ex. Transport-nod.

Linux: MeshChatX - se ovan.

MacOS: MeshChatX - se ovan.

iOS: Har under en längre tid haft problem med brist på klienter. R3tina ser lovande ut där huvudfunktionen nu i tidigt stadie verkar vara LXMF, förnärvarande i TestFlight Beta.

Nästa steg¶

• Installera Reticulums terminalverktyg
• Så hittar trafiken fram
• Använd Reticulum över LoRa med RNode
• Reticulums guide Getting Started Fast