[{"data":1,"prerenderedAt":172},["ShallowReactive",2],{"doc-home":3},{"id":4,"title":5,"body":6,"description":162,"edit":163,"extension":164,"meta":165,"navigation":166,"path":167,"seo":168,"stem":169,"vertical":163,"weight":170,"__hash__":171},"content\u002Findex.md","OpenSense documentation",{"type":7,"value":8,"toc":154},"minimark",[9,13,24,60,65,73,89,94,105,109,131,135],[10,11,12],"p",{},"OpenSense is a telemetry SaaS for small operations in the EU. One backend reads\nany combination of temperature, humidity, CO₂, leak, pressure, power and\nvoltage sensors. Five verticals share the same pipeline: HACCP cold chain,\nLegionella in hot water, server-room monitoring, indoor climate, and energy.",[10,14,15,16,23],{},"This site is the technical reference. If you are evaluating the product, read\nthe ",[17,18,22],"a",{"href":19,"rel":20},"https:\u002F\u002Fopensense.murzin.digital",[21],"nofollow","marketing site"," first.",[25,26,27,36,44,52],"cards",{},[28,29,33],"card",{"icon":30,"title":31,"to":32},"01 · 5 min","Quickstart","\u002Fgetting-started\u002Fquickstart",[10,34,35],{},"Pair your first Shelly H&T, see the chart, fire a fake alarm. Five minutes,\nno soldering, no cabling.",[28,37,41],{"icon":38,"title":39,"to":40},"02 · model","Concepts","\u002Fgetting-started\u002Fconcepts",[10,42,43],{},"Sites, devices, sensors, channels, alerts, retention. The seven nouns that\nappear everywhere else in this manual.",[28,45,49],{"icon":46,"title":47,"to":48},"03 · pipe","HTTP & MQTT API","\u002Fapi\u002Foverview",[10,50,51],{},"Send measurements from any source: cURL, ESPHome, Arduino, TTN, Shelly,\nMQTT broker. Idempotency, rate limits, error codes.",[28,53,57],{"icon":54,"title":55,"to":56},"04 · rules","Verticals","\u002Fverticals\u002Fhaccp",[10,58,59],{},"Concrete thresholds, regulations and report templates for each of the five\nverticals we support out of the box.",[61,62,64],"h2",{"id":63},"what-this-is-what-it-isnt","What this is, what it isn't",[10,66,67,68,72],{},"OpenSense ",[69,70,71],"strong",{},"is",":",[74,75,76,80,83,86],"ul",{},[77,78,79],"li",{},"A multi-tenant ingest pipeline that accepts sensor readings over HTTP, MQTT\nand LoRaWAN (TTN webhook).",[77,81,82],{},"A storage layer that retains raw measurements for 13 months and downsampled\nrollups (5 min \u002F 1 h \u002F 1 d) for five years.",[77,84,85],{},"A rule engine that triggers Telegram, email and webhook alerts when a\nchannel leaves the configured operating range.",[77,87,88],{},"A reporting layer that generates one-click PDF reports per vertical: HACCP\nfridge logs, Legionella supply\u002Freturn curves, server-room uptime, climate\ncompliance, energy baselines.",[10,90,67,91,72],{},[69,92,93],{},"is not",[74,95,96,99,102],{},[77,97,98],{},"A SCADA replacement. We are honest about the budget: 1–10 sensors per site,\nnot a full industrial plant.",[77,100,101],{},"A hardware vendor. We do not sell sensors. You buy them from Amazon, Shelly,\nAqara, Efento or any other vendor, then point them at our ingest URL.",[77,103,104],{},"A general-purpose IoT platform. We pick five verticals and write the rule\ntemplates and report templates for them. If your use case is something else\nentirely, you can still use the API — but you are on your own for the\ntemplates.",[61,106,108],{"id":107},"operator-vs-developer","Operator vs developer",[10,110,111,112,115,116,119,120,122,123,126,127,130],{},"This manual is split. If you are setting up sensors and reading reports, stay\nin ",[69,113,114],{},"Getting started",", ",[69,117,118],{},"Hardware"," and ",[69,121,55],{},". If you are integrating\ncustom hardware or building your own dashboard, ",[69,124,125],{},"API"," is the section you\nwant. ",[69,128,129],{},"Troubleshooting"," is shared.",[61,132,134],{"id":133},"working-assumptions","Working assumptions",[74,136,137,145,148,151],{},[77,138,139,140,144],{},"All data lives in the ",[141,142,143],"code",{},"eu-central"," region. Account creation in any other\nregion is not currently possible.",[77,146,147],{},"All times are stored in UTC. The dashboard renders in the browser's local\ntimezone; PDF reports render in the site's timezone (configured per site).",[77,149,150],{},"All readings are stored with full sensor precision. Display rounding happens\nin the UI only.",[77,152,153],{},"Magic-link authentication is the only auth method for the web UI. API tokens\nare scoped per device for ingest and per user for management.",{"title":155,"searchDepth":156,"depth":156,"links":157},"",3,[158,160,161],{"id":63,"depth":159,"text":64},2,{"id":107,"depth":159,"text":108},{"id":133,"depth":159,"text":134},"Reference manual for operators and developers",null,"md",{},true,"\u002F",{"title":5,"description":162},"index",1,"sHwDQjOkq7CqQTJp-nWx8pr1DFl6t-NB6iLHmZepC50",1779022953202]