Skip to content

JunctionRelay Documentation

Welcome to the official documentation for JunctionRelay — a unified platform for data orchestration, device management, and local + cloud hybrid control.


What is JunctionRelay?

JunctionRelay is a comprehensive IoT platform that bridges the gap between local device control and cloud-based data management. Whether you're a hobbyist building sensor networks, an enterprise managing industrial IoT deployments, or a developer creating connected applications, JunctionRelay provides the tools you need for:

  • Device Management - Flash, configure, and monitor devices locally and remotely
  • Data Collection - Stream sensor data from multiple sources with flexible payload structures
  • Service Integration - Connect with popular platforms like Grafana, Home Assistant, and MQTT brokers
  • Hybrid Control - Run locally for privacy and performance, sync to cloud when needed
  • Visual Dashboards - Create custom layouts and visualizations for your data

Documentation Sections

☁️ JunctionRelay Cloud - User Guide

Get started quickly with the hosted cloud service. The Cloud Dashboad can be used standalone, or synchronzed with your local backend server(s)

🚀 Cloud Only Device Examples

Connect your Arduino / Raspberry Pi devices to JunctionRelay Cloud quickly and easily with these demo templates to quickly enable cloud registration, health reporting and secure sensor transmission

🗄️ JunctionRelay Server - User Guide

Comprehensive guides for self-hosting JunctionRelay on your own hardware. Includes installation instructions for Unraid, Raspberry Pi, Windows, and more

🛠️ Developer Documentation

Technical deep-dives covering architecture, security, APIs, and contribution guidelines for developers extending the platform

🏠 Example Builds

Complete hardware projects with step-by-step instructions, code examples, and demonstration videos


Quick Starts

New to JunctionRelay? Choose your path:

  1. Create an account on our hosted platform
  2. Follow 1 of the following demos to connect your first device

🏠 Self-Host from Day One

  1. Install the server on your preferred platform
  2. Flash an ESP32 device with JunctionRelay firmware
  3. Connect and configure your first data collectors
  4. Set up integrations with your existing tools & services

Example Builds

Feather ESP32 S3 QtPy ESP32 S3 SparkleMotion Mini
Feather QtPy SparkleMotion
CrowPanel 5 – Plotters CrowPanel 7 – Grids
CrowPanel5 CrowPanel7