Under active development. Breaking changes expected. APIs, installers, and UI may shift between releases.
Five uplinks. One router. No reconfig.
Usable today. Early access — some pieces run behind a feature flag and APIs may shift between releases.
UPLINK MATRIX
Everything you plug in is a path.
The uplink router picks by priority. Override the defaults per site through the Hardware tab or the setup webapp.
| Role | Priority | Typical use | Behavior | |
|---|---|---|---|---|
| WiFi AP | Always on | local | Serves laptop and phone clients | Local only, not a cloud path |
| Ethernet | Best cloud path | 1 | Bench, lab, fixed sites | Chosen first when the link is up |
| WiFi client | Join a network | 2 | Venue hotspot, office lab | Used when Ethernet is down |
| Cellular | Wireless fallback | 3 | Remote sites, no wired path | Used when both wired paths are down |
| USB tether | Laptop only | 4 | Bench debug, indoor lab | Lowest priority, laptop-side only |
WiFi AP
Ethernet
WiFi client
Cellular
USB tether
FAILOVER
Three strikes, then switch.
The uplink router runs a short health check on the chosen path. Three consecutive failures trigger failover. Three consecutive successes on a higher-priority path switch back.
The health check is a cheap probe on the active uplink every 15 seconds. Three failures in a row move the active uplink to the next priority. On lower-priority paths the check runs every 60 seconds, and three successes flip the active back. This pattern avoids flapping on a marginal link.
A priority list beats round-robin for a field station because the operator usually knows Ethernet is cheaper than WiFi, which is cheaper than cellular. The agent honors that intent and does not try to stripe bandwidth across paths.
SHARE UPLINK
Give the whole field team internet.
Turn on share-uplink and the node becomes a NAT gateway for its own WiFi access point clients. One node, one cellular modem, every laptop and phone on the site gets online.
Share-uplink writes an iptables MASQUERADE rule from the access point subnet to the active cloud uplink. Access point clients get internet. The rule is persisted so it survives reboots and it is removed cleanly when the feature is turned off. Data-cap throttling applies to the shared path as well.
This is a convenience feature. Turn it on for a small team at a remote site. Turn it off when you are on a metered plan and want only the video stream on the cellular path.
Plug in the path. The router picks it up.
Uplink configuration, failover tuning, and cloud relay setup are covered in the public docs.
Networking docs