Skip to main content

Choosing your setup

Choose a device to run Ratspeak and a connection to other Reticulum users. A phone or computer can use a local network, an internet connection, Bluetooth Peer, or an attached radio. A supported handheld can run its own messenger.

Pick a scenario​

You want to…Start with
Send messages from a computerRatspeak for macOS, Linux, or Windows
Send messages from a phone or tabletRatspeak for Android, or the iOS TestFlight beta
Reach peers through the internetRatspeak with an Internet/TCP connection
Add LoRa to a phone or computerRatspeak and compatible RNode hardware
Carry a self-contained LoRa messengerRatspeak Handheld on a supported device
Run a transport or propagation servicernsd-rs, with lxmd-rs for LXMF propagation

Just the Ratspeak desktop app​

Install Ratspeak, create or restore an identity, then turn on a connection in the Network tab. A fresh install has no interfaces enabled. For two devices on the same Wi-Fi or LAN, turn on Local Network on both. To reach peers through the internet, turn on Internet and join a server.

The first-session guide walks through connecting and sending a message. Installing a separate Reticulum daemon is optional; the app includes its own networking runtime.

Ratspeak desktop + a TCP server​

In Network, turn on Internet and choose Join beside a listed server, or choose Add your own server and enter its address and port. You can use an existing public server or one you operate yourself. The server provides a connection to the Reticulum destinations it can reach; it does not make every user reachable.

See IP, LAN and I2P for connection details and Infrastructure and ops for hosting.

Ratspeak mobile​

Android installs from an APK; iPhone and iPad use the public TestFlight beta.

For radio connections, Android supports USB-OTG, Bluetooth LE and RNode over TCP where the device and radio support them. On iOS, use a compatible Bluetooth RNode or a reachable RNode TCP bridge. General USB serial radios are not available through the iOS app.

Bluetooth Peer connects compatible nearby Ratspeak devices without a radio or Wi-Fi router. Its capabilities vary by platform; check Bluetooth interfaces before relying on it for your setup.

Ratspeak + an RNode or RNode-mode handheld​

An RNode supplies the LoRa radio while Ratspeak on your phone or computer provides the messaging interface. Connect it over USB, Bluetooth LE, or a TCP bridge, depending on the radio firmware and host platform.

T-Deck Plus, T-Pager and Cardputer Adv can also run the RNode mode supplied with Ratspeak Handheld. They must be in that mode when another app controls their radio. See LoRa and RNode for configuration and supported boards for hardware details.

Standalone handhelds​

Ratspeak Handheld is the shared firmware for these devices:

DeviceAvailable modes
LilyGO T-Deck PlusStandalone messenger and RNode
LilyGO T-Pager with SX1262Standalone messenger and RNode
M5Stack Cardputer AdvStandalone messenger and RNode; Cap LoRa-1262 required for LoRa
Elecrow ThinkNode M9Standalone messenger

The firmware uses rsReticulumLite and rsLXMFLite. Older material may call the device builds rsDeck, rsPager or rsCardputer; current downloads come from the Ratspeak Handheld release.

Use the flashing guide to choose the correct image, then the handheld guide for controls, messaging and storage. Hardware, input methods and features vary by device.

Self-hosted transport node​

Run rnsd-rs when you want to operate a Reticulum transport node. Configure transport mode and the interfaces it should connect; starting a daemon alone does not establish those connections. Add lxmd-rs in propagation-node mode if you also want to store messages for later pickup.

These services are useful for network operators and are not prerequisites for using the Ratspeak app. See Infrastructure and ops.

What you actually need​

For messaging, you need an identity, a working interface and a route to the recipient or an applicable propagation node. Local-network and radio connections can work without internet access. Internet TCP servers require an internet connection. Ratspeak messaging does not require a central account or a public IP address.

Continue with Install and platform setup or Your first session.