The open gateway OS for LoRaWAN, Bluetooth LE and IP devices, built on OpenWrt.
Documentation · Quick start · Hardware · Releases
PulzrOS turns a Raspberry Pi, a RAK WisGate or a GL.iNet router into a managed gateway. It runs the LoRa packet forwarders, forwards Bluetooth LE, routes for IP devices, and fails over between ethernet, WiFi and cellular. A gateway adopts itself into the cloud when somebody scans its code, takes signed firmware updates, and is managed from a web console it serves itself or the same pages in a terminal over serial, SSH, HDMI or USB.
| Board | Radio | Install |
|---|---|---|
| Raspberry Pi 3, 4, 5 | any SPI, USB or UART concentrator, probed | SD card |
| RAK7391 WisGate Connect | two mPCIe slots, probed | SD card |
| RAK7268V2 / CV2 WisGate Edge Lite 2 | 8 channels | sysupgrade |
| RAK7289V2 / CV2 WisGate Edge Pro | 16 channels | sysupgrade |
| RAK7266, RAK7267 | 8 channels | sysupgrade |
| GL.iNet GL-SFT1200 Opal | none: a router for IP devices | sysupgrade |
Every board, with what is verified on hardware, is on the hardware pages.
- Download the image for your board from the latest release.
- Flash it with Raspberry Pi Imager (Use custom), Etcher or
./flash.sh --download rpi4. - Open the console: plug a laptop into the gateway's ethernet port and browse to
https://pulzr-<serial>.local. Scan the claim code to adopt it.
The full walk-through is in Getting started.
./build.sh rpi4Needs Node 20+, curl, jq, zstd, and Linux or Docker for image assembly. See Building from source.
Board support, fixes and documentation are welcome. Read CONTRIBUTING.md and the contributor guide. Commits are signed off under the DCO.
Report vulnerabilities to security@pulzr.net, not in an issue. See SECURITY.md.
PulzrOS is Apache-2.0. Images also contain OpenWrt and its packages and the ChirpStack gateway binaries, each under its own license: see NOTICE and THIRD-PARTY-NOTICES.md.