RING
RINGSetup & configuration
RING prepares the configuration in your browser. You install the package on your server; live readings then travel through that server’s services.

Sensors in the field send readings by LoRa radio to a LoRaWAN gateway. The gateway passes them over the network to a server whose LoRaWAN services RING has set up from your deployment choices.

You provideSensors, a gateway, and a Linux server
Your site’s choices
RINGConfigures your setup, in your browser
RING prepares
Your setup packageA deployment ZIP, configured for your site
You run the installer
Your serverOn site or in the cloud: your data stays there
Indoor sensor
Outdoor sensor
LoRa radio · US915
RAK7393 gatewayReceives the sensors’ radio packets
Basics Station over the network
Purdue server · mini PCLoRaWAN stack and MySQL storage
Website requests · telemetry API
Purdue’s live sensor dataThis site’s charts, served by Nginx

Prepared in your browser

Guided deployment

RING

Remote IoT4Ag Network Gateway

RING turns your site’s choices into a configured LoRaWAN setup package, then guides you to a first reading on your own dashboard.

The path to a first reading

  1. Prepare the server

    Choose a local or cloud Linux server and prepare SSH and Docker.

  2. Generate the package

    Choose your site settings; download the ZIP made in your browser, with configuration files, installation and verification tools, telemetry storage, and your site’s dashboard.

  3. Install and check

    Run the installation commands yourself, then check the services.

  4. Connect gateway and sensor

    Connect the gateway, then add the sensor from the dashboard.

  5. Verify a dashboard reading

    Enable the sensor and follow its first reading onto your dashboard.

The website creates the package in your browser. You run every installation command yourself. Automated remote installation remains in development.

Start guided setupAbout the project

How setup works

Six guided stages take you from a bare server to your first dashboard reading. In short:

  1. 01

    Get a server ready

    Use a mini-PC on site, or create a cloud server on AWS or Google Cloud. RING guides you through Ubuntu, SSH, and Docker, then checks the server.

  2. 02

    Download your setup package

    Answer three questions about your site. RING builds a small ZIP in your browser with everything configured for your server.

  3. 03

    Install and check

    Copy the package to the server and run the installer. Confirm all eleven services, then sign in to ChirpStack and open your dashboard.

  4. 04

    Connect the field

    Connect your gateway, then add each sensor from your own dashboard and watch its first reading arrive.

Where RING fits

A LoRaWAN network has two halves: radio hardware in the field, and software on a server that receives what the hardware sends. RING sets up the server half from a few answers, so the field half has somewhere to connect.

You bring
Soil sensors, a LoRaWAN gateway, and a Linux server: a mini-PC on site, or a virtual machine in the cloud.
What RING sets up for you
Technical details: exact versions

Each installation runs these pinned versions, as Docker containers, so every server gets the same software.

ChirpStack
4.3.2
ChirpStack REST API
4.3.0
ChirpStack Gateway Bridge
4.0.10
Mosquitto
2.0.15
PostgreSQL
14.8
Redis
7.0.11
MySQL
8.4.11
Nginx (dashboard)
1.27.5
You get
A LoRaWAN server you can sign in to and your own RING dashboard, ready for your gateway and sensors.

System architecture

For technical and research readers: every service the package runs on your server, and how a reading travels between them.

In the fieldDraginoSE01-LSRAK7393gatewayLoRa(US915 sub-band 2)User’s Linux server: one Compose projectgateway-bridge(Basics Station)mosquittochirpstack+ postgres, redistelemetry-ingestmysqltelemetry-apidashboard(Nginx)decoded uplinks/api/telemetry/public/*ws://ADDRESS:PORTBrowser: SSH tunnel,LAN, or Tailscale

Scroll sideways to see the whole figure.

Figure 1. The setup package on a user’s own Linux server: one Docker Compose project, from the sensor’s radio uplink to the site’s own dashboard. Cylinders are message and data stores; labels name the protocol, topic, or path a connection uses.

In the field, a Dragino SE01-LS sensor sends LoRa radio, US915 sub-band 2, to a RAK7393 gateway. The gateway connects over WebSocket to gateway-bridge, the Basics Station listener, on the user’s Linux server. Gateway-bridge publishes to the mosquitto MQTT broker, which exchanges messages with chirpstack, backed by postgres and redis. Mosquitto passes decoded uplinks to telemetry-ingest, which stores them in mysql; telemetry-api reads mysql. The dashboard, behind Nginx, requests readings from telemetry-api at /api/telemetry/public/. People reach the dashboard in a browser through an SSH tunnel, the local network, or Tailscale.

Table 1. The package’s services by layer.
LayerServices
LoRaWANchirpstack, gateway-bridge, mosquitto, postgres, redisReceives the gateway’s packets, joins devices, decodes payloads with the device profile’s codec, and publishes uplinks on MQTT.
Telemetrymysql, telemetry-migrate, telemetry-ingest, telemetry-apiRING’s telemetry service, built on the server from its bundled source: stores each decoded uplink and serves sanitized readings.
DashboarddashboardThe site’s own RING dashboard behind Nginx, reading only the public, read-only API routes.

Built for field deployment

Research plots
Set up gateways and sensors without rebuilding the software environment at every location.
Farm and field trials
Move hardware between deployments while keeping the setup process consistent.
University research
Give students and researchers a guided workflow instead of a long terminal checklist.

See what’s happening in the field

RING runs its own small deployment at Purdue. The soil sensors report about every 20 minutes, and every reading is kept.

View SensorsView Weather

Soil temperature, last 24 hours

Research context

Developed within Purdue University’s Department of Agricultural and Biological Engineering as part of ongoing digital agriculture research.

The project is connected to IoT4Ag, the Internet of Things for Precision Agriculture research center. Its sensors report from the IoT4Ag laboratory and from a plot outdoors.

About the project

Ready to set up a deployment?

Setup runs in your browser and never connects to your server. You run each step yourself and check the result before moving on.

Start setup