[{"data":1,"prerenderedAt":321},["ShallowReactive",2],{"doc-\u002Fgetting-started\u002Fquickstart":3},{"id":4,"title":5,"body":6,"description":311,"edit":312,"extension":313,"meta":314,"navigation":315,"path":316,"seo":317,"stem":318,"vertical":312,"weight":319,"__hash__":320},"content\u002Fgetting-started\u002Fquickstart.md","Quickstart",{"type":7,"value":8,"toc":300},"minimark",[9,19,24,36,39,45,49,57,98,102,139,149,176,181,185,192,199,203,210,244,254,258],[10,11,12,13,18],"p",{},"This walkthrough takes about five minutes, assumes you have one Shelly H&T\nPlus (or a Shelly H&T Gen3) and a phone or laptop on the same WiFi as the\nsensor. We use Shelly because it is the cheapest commodity sensor that ships\nwith HTTP push out of the box. If you already use another sensor, jump to\nthe ",[14,15,17],"a",{"href":16},"\u002Fhardware","Hardware"," section.",[20,21,23],"h2",{"id":22},"_1-create-the-opensense-account","1 · Create the OpenSense account",[25,26,28],"cmd",{"label":27},"$ browser",[10,29,30,31],{},"open ",[14,32,33],{"href":33,"rel":34},"https:\u002F\u002Fopensense.murzin.digital\u002Fsignup",[35],"nofollow",[10,37,38],{},"Enter your email. You will receive a six-character magic-link code. Paste it\ninto the login screen. No password to remember.",[40,41],"stoplight",{"alarm":42,"ok":43,"warn":44},"No email after 60 s. Check the address; click ‘resend’ at most twice.","You land on \u002Fapp\u002Fsites with an empty state.","Email arrived in spam.",[20,46,48],{"id":47},"_2-create-a-site","2 · Create a site",[10,50,51,52,56],{},"A ",[53,54,55],"strong",{},"site"," is one physical address: a café, a hotel kitchen, a server room.\nReports are scoped per site. Most accounts have one site; chains can have\nmany.",[58,59,60,69,79,88],"ul",{},[61,62,63,64,68],"li",{},"Click ",[65,66,67],"code",{},"+ NEW SITE",".",[61,70,71,72,75,76,68],{},"Set ",[65,73,74],{},"Name",", e.g. ",[65,77,78],{},"Kava Bratislava",[61,80,71,81,75,84,87],{},[65,82,83],{},"Timezone",[65,85,86],{},"Europe\u002FBratislava",". This drives PDF report rendering.",[61,89,71,90,93,94,97],{},[65,91,92],{},"Vertical"," to ",[65,95,96],{},"haccp",". The vertical configures default thresholds and\nthe report template. You can change it per device later.",[20,99,101],{"id":100},"_3-pair-the-shelly","3 · Pair the Shelly",[103,104,105,111,118,125,128],"ol",{},[61,106,107,108,68],{},"Power up the Shelly H&T. The LED blinks blue while it advertises a setup\nWiFi network named ",[65,109,110],{},"ShellyHT-XXXXXX",[61,112,113,114,117],{},"On your laptop, join that WiFi. Open ",[65,115,116],{},"http:\u002F\u002F192.168.33.1",". The Shelly\nweb UI loads.",[61,119,120,121,124],{},"In ",[65,122,123],{},"Settings → WiFi",", configure your real WiFi. Save. The Shelly reboots\nonto your network.",[61,126,127],{},"Find the new IP of the Shelly (router admin page, or the Shelly app, or\nnmap). Note it down.",[61,129,130,131,134,135,138],{},"In OpenSense, on the empty site, click ",[65,132,133],{},"+ ADD DEVICE → SHELLY → H&T",".\nCopy the ",[53,136,137],{},"ingest URL"," the dialog shows. It looks like:",[25,140,142],{"label":141},"$ ingest url",[10,143,144],{},[14,145,148],{"href":146,"rel":147},"https:\u002F\u002Fapi.opensense.murzin.digital\u002Fv1\u002Fingest\u002Fshelly?token=ds_live_4f3c%E2%80%A6&device=hut01",[35],"https:\u002F\u002Fapi.opensense.murzin.digital\u002Fv1\u002Fingest\u002Fshelly?token=ds_live_4f3c…&device=hut01",[103,150,152,167],{"start":151},6,[61,153,154,155,158,159,162,163,166],{},"Back in the Shelly web UI, go to ",[65,156,157],{},"Settings → Actions → Report sensor values"," (called ",[65,160,161],{},"Reporting URL"," on Gen3). Paste the ingest URL. Set\nreporting interval to ",[65,164,165],{},"60"," seconds (this is also the default and is fine\nfor HACCP).",[61,168,63,169,172,173,68],{},[65,170,171],{},"Save",". Click ",[65,174,175],{},"Send test",[40,177],{"alarm":178,"ok":179,"warn":180},"Device stays grey after 2 min. See troubleshooting \u002F device offline.","OpenSense shows a green dot next to the device and a first reading within 5 s.","Reading appears after 60 s only — the Shelly waited for its next scheduled report. Fine.",[20,182,184],{"id":183},"_4-see-the-chart","4 · See the chart",[10,186,187,188,191],{},"Click the device. The default view is ",[65,189,190],{},"last 24 h"," with a temperature and a\nhumidity series. The chart is live: new points appear without reload.",[10,193,194,195,68],{},"For a 5-minute test, breathe near the sensor. Humidity should jump 3–6 %\nwithin two reporting cycles. If it does not, the sensor is broken or\nunpaired; see ",[14,196,198],{"href":197},"\u002Ftroubleshooting\u002Fwrong-readings","wrong readings",[20,200,202],{"id":201},"_5-fire-a-fake-alarm","5 · Fire a fake alarm",[10,204,205,206,209],{},"By default a HACCP site has a temperature rule on every device:\n",[65,207,208],{},"-2 °C ≤ T ≤ +8 °C"," with a 15-minute grace period. To verify the alarm path\nwithout a real cold-chain event:",[103,211,212,219,226,233],{},[61,213,214,215,218],{},"Open the device's ",[65,216,217],{},"Rules"," tab.",[61,220,221,222,225],{},"Edit the rule: set ",[65,223,224],{},"T ≤ +30 °C"," (any value below room temperature).",[61,227,228,229,232],{},"Save. Within one reporting cycle the channel is in ",[53,230,231],{},"ALARM",", you get a\nTelegram message (if connected) and an email.",[61,234,235,236,239,240,243],{},"Restore the rule back to ",[65,237,238],{},"+8 °C",". Within two cycles the channel returns to\n",[53,241,242],{},"OK",". The alarm is logged as an event in the audit trail.",[245,246,251],"reg",{"code":247,"jurisdiction":248,"source":249,"title":250},"EU 852\u002F2004","EU food law","https:\u002F\u002Feur-lex.europa.eu\u002Flegal-content\u002FEN\u002FTXT\u002F?uri=CELEX%3A02004R0852-20210324","Why temperature is logged at all",[10,252,253],{},"HACCP requires food businesses to monitor and document critical control\npoints. Cold-storage temperature is the most common CCP. OpenSense replaces\nthe paper logbook by recording a measurement per minute and producing a\nmonth-end PDF the inspector accepts.",[20,255,257],{"id":256},"whats-next","What's next",[58,259,260,268,285,292],{},[61,261,262,263,267],{},"Configure ",[14,264,266],{"href":265},"\u002Fverticals\u002Fhaccp","verticals"," to fit your operation.",[61,269,270,271,275,276,280,281,68],{},"Add more devices: ",[14,272,274],{"href":273},"\u002Fhardware\u002Faqara-th","Aqara TH",", ",[14,277,279],{"href":278},"\u002Fhardware\u002Fefento-ns-t","Efento NS-T",",\nor ",[14,282,284],{"href":283},"\u002Fhardware\u002Fdiy-esp32","DIY ESP32",[61,286,287,288,68],{},"Generate your first ",[14,289,291],{"href":290},"\u002Fapi\u002Freports","report",[61,293,294,295,299],{},"Read the ",[14,296,298],{"href":297},"\u002Fgetting-started\u002Fconcepts","concepts"," page to understand sites,\ndevices, sensors and channels before adding much more data.",{"title":301,"searchDepth":302,"depth":302,"links":303},"",3,[304,306,307,308,309,310],{"id":22,"depth":305,"text":23},2,{"id":47,"depth":305,"text":48},{"id":100,"depth":305,"text":101},{"id":183,"depth":305,"text":184},{"id":201,"depth":305,"text":202},{"id":256,"depth":305,"text":257},"Pair a Shelly H&T in five minutes",null,"md",{},true,"\u002Fgetting-started\u002Fquickstart",{"title":5,"description":311},"getting-started\u002Fquickstart",10,"s_9yGo5rKFk91imF5cA29DTEkTBW2ZqY5Hue9ZVCxMs",1779022953277]