Tutorials

📄️White-label your IoT platform with multi-tenant realms

This tutorial shows how to turn OpenRemote into a white-label, multi-tenant IoT platform: you will brand the Manager with your own logo and colours, give each customer (or distributor) their own isolated realm, and optionally serve it on a custom URL. This is exactly what device manufacturers (OEMs) and system integrators need when they want to resell an IoT solution under their own brand.

📄️Using HTTP Agent for weather service

This tutorial explains how to use the generic HTTP Agent with an example to connect to the OpenWeatherMap API.

📄️Connect your MQTT Client

In this tutorial we will use the MQTT API to subscribe to changes of asset attributes values and publish data to them from a MQTT Client. The OpenRemote Manager functions as the MQTT Broker. You can use a desktop MQTT client (e.g. MQTT Explorer or MQTT X) for this tutorial, or better yet the device you want to connect.

📄️ChirpStack LoRaWAN Integration

ChirpStack is an open source LoRaWAN network server stack. This tutorial explains how to receive LoRaWAN sensor data via ChirpStack using the MQTT Agent. The tutorial is based on the Dragino LHT65 LoRaWAN sensor device as an example.

📄️Connect Modbus TCP/Serial devices (PLCs, meters, inverters)

Modbus is everywhere in industrial and energy hardware - PLCs, energy meters, solar inverters, HVAC controllers. This tutorial shows how to connect Modbus devices to OpenRemote running as a gateway, using the native Modbus agent, mapping registers straight onto asset attributes over Ethernet (Modbus TCP) or serial (Modbus Serial).

📄️Enterprise identity - SSO, RBAC and OAuth2

How does our platform handle identity and access? This tutorial covers the essentials: single sign-on (SSO/OIDC) through the built-in Keycloak, linking to Active Directory/LDAP, role-based access control (RBAC) with realms and restricted users, and OAuth2 service accounts for headless device and machine access.

📄️Deploy OpenRemote as an edge gateway with a secure tunnel

For sites with intermittent connectivity, local control loops or data-residency requirements, you want compute at the edge. This tutorial shows how to run OpenRemote as an edge gateway, link it to a central instance, and remotely access the on-site gateway through a secure tunnel - a hybrid on-premise plus cloud architecture.

📄️Auto-provision and onboard OEM devices at scale

If you build and distribute your own hardware, you do not want to register every unit by hand. This tutorial shows how auto-provisioning lets a device self-register the first time it connects: OpenRemote authenticates it, creates an asset of the type you defined, and links its attributes to the right MQTT topics - true zero-touch device onboarding.

📄️Over-the-air (OTA) firmware updates

Shipping hardware means shipping bugs you will need to fix later. This tutorial shows how to deliver over-the-air (OTA) firmware updates to a device fleet using OpenRemote's integration with Eclipse hawkBit - a dedicated software update server with managed rollouts and campaigns, not just a file drop.