GUIDES
Tutorials
Still deciding whether to adopt Device Agent, rather than already building
with it? See the main README's
Is this for you? section, plus
../FAQ.md and ../TROUBLESHOOTING.md
first — these guides assume you've already decided.
Narrative, step-by-step walkthroughs for Zyvor Device Agent. Read them in order the first time through; after that, jump straight to whichever one matches what you're doing.
Looking for a fact instead of a walkthrough (an API field, a config key, a protocol detail)? See the reference docs linked from the main README's Documentation section instead — these guides link out to them wherever the two overlap, on purpose, rather than repeating them.
| # | Guide | You'll come away able to... |
|---|---|---|
| 1 | Getting started | Build the agent and dashboard from source and see live hardware inventory on screen |
| 2 | Configuration & the API | Read/edit device-agent.toml with confidence and call the REST API directly |
| 3 | Securing your agent | Pick the right auth mode (none / bearer / mTLS / Unix socket) and whether to add plain TLS, for your deployment |
| 4 | Industrial buses | Monitor CAN health, declare RS485 ports, and turn on read-only CAN capture |
| 5 | Writing a sensor plugin | Write, register and sample a new sensor plugin end to end |
| 6 | Deploying to production | Ship a package or remote deployment, reload config live, and scrape metrics |
| 7 | Container deployment | Pull the published image and run it, with or without systemd supervision |
| 8 | Camera streaming | Live snapshot and MJPEG stream from a USB/CSI camera |