Skip to main content

Building from source

Prefer to compile the firmware yourself to test a patch, audit exactly what runs on your device, or work offline? Which toolchain you use depends on the board:

  • rsDeck (LilyGO T-Deck) and rsCardputer build with PlatformIO from their Ratspeak repositories.
  • RNode-class boards (Heltec LoRa32, T-Beam, generic RNode) use rnodeconf, the upstream RNode toolchain that ships with Reticulum.
Just want a working device?

Most people should use the web installer; it's faster, and requires no toolchain. See Webinstaller flashing.

Pick your board

BoardFirmwareToolchainGuide
LilyGO T-Deck PlusrsDeckPlatformIOBuild rsDeck →
Heltec LoRa32RNodernodeconfFlash with rnodeconf →

Common prerequisites

Both paths need:

  • A computer running Linux, macOS, or Windows
  • git
  • Python 3.9+ with pip — both PlatformIO and rns/rnodeconf install through it
  • A USB-C data transfer cable and your board
warning

Attach an antenna matched to your frequency band before powering or testing a LoRa radio. Transmitting without one can damage the radio module.

The canonical firmware reference is the official flashing guide.