Praesens.io

Edge Setup Guide

Sign in, download the runtime, mint one enrollment code, configure the edge node, and verify live output.

Before You Begin

Access identity Your email must be allowed in Cloudflare Access.
Camera streams Have clear and fluent RTSP URLs ready for the setup wizard.
Local runtime Use a Windows host with Docker Desktop and Python/Tkinter.
Scene measurements Prepare at least five anchor points with known latitude and longitude.

Credential Roles

Cloudflare Access Human sign-in for the map and provisioning UI.
Enrollment code Single-use, time-limited setup code for one sensor.
Sensor bearer key Publisher credential returned once to the edge runtime.

Field users do not need Cloudflare control-plane access. The edge runtime stores the publisher credential locally and uses it only to publish validated sensor state and diagnostics.

Setup Steps

  1. 1

    Sign In

    Open the map site and complete Cloudflare Access sign-in with the operator email that was added to the allow policy.

    https://map.praesens.io
  2. 2

    Download The Runtime

    Use the map setup panel or the link above to download the edge runtime ZIP. Extract it into one folder and keep the package layout intact.

    praesens-edge-runtime/START_HERE.md
  3. 3

    Mint One Enrollment Code

    Open provisioning from the map or this page. Mint one code for one sensor node, then copy it into the setup wizard before it expires.

    Single use. Expires after 15 minutes.
  4. 4

    Start The Setup Wizard

    In the extracted package, double-click the no-terminal setup app. If Windows blocks script launchers, use the PowerShell fallback from the package root.

    Praesens Edge Setup.pyw
  5. 5

    Enter Sensor And Stream Details

    Add the friendly sensor name, clear stream, fluent stream, and enrollment code. The wizard checks RTSP host and port reachability before enrollment.

    Use placeholders in notes. Do not paste RTSP URLs into shared docs.
  6. 6

    Configure Position, Detection, And Calibration

    Enter camera site coordinates, select emitted classes, tune smoothing only when needed, upload a current screenshot, place at least five anchors, and draw the ROI polygon.

    ROI accepts in-mask detections and drops objects outside the mask.
  7. 7

    Start Docker And Run Health

    Let the wizard start Docker, or use the runtime scripts. The strict health check should show real inference and avoid stub mode before field validation.

    .\edge\scripts\health.ps1 -Strict
  8. 8

    Confirm Live Output

    Watch for accepted tracks in the map and verify the expected operational output path, such as TAK, receives the same stable live position without noticeable delay.

    Map track, Validation Inspector, and TAK should agree.

Troubleshooting

Access page does not load Confirm the operator email is in the Access allow policy.
Mint is denied Access may be valid but the identity may not be owner/admin.
Enrollment fails Mint a fresh code and check for mistyped, expired, or used codes.
Stream preflight fails Check IP, port, network path, and whether the camera is online.
No map tracks Check class selection, confidence, ROI, movement gates, and publish auth.
Stub mode appears Fix runtime/model or camera availability before live validation.