1. Create a sensor
In the console open Gate → Sensors → New sensor. A sensor is one machine or service that sends events. Its token (gk_live_…) is shown once: copy it, it is stored only as a hash.
Tokens are per environment (live, test, staging). The environment's secret key (sk_live_…) also works, with the sensor name in the body.
2. Install the agent
On the Linux host, run the command the console shows. The agent starts in dry-run: it sends events and computes what it would block, but changes no firewall rule.
# Console → Gate → Sensors → New sensor shows this command with your token
curl -fsSL https://api.pryntid.com/v1/gate/agent/install.sh | sudo sh -s -- \
--token gk_live_YOUR_SENSOR_TOKEN \
--parser traccar:/opt/traccar/logs/tracker-server.log \
--parser sshd:journal:ssh.service \
--bouncer nftables # dry-run until you pass --enforceAgent and bouncer has the Docker variant, the configuration and how to switch to enforce.
3. Send a test event
Without the agent, from any machine:
curl https://api.pryntid.com/v1/gate/events \
-H "Authorization: Bearer gk_live_YOUR_SENSOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"events":[{"eventId":"test-1","port":22,"protocol":"ssh",
"srcIp":"203.0.113.7","claimedIdentity":{"type":"username","value":"root"},
"outcome":"auth_fail"}]}'It appears in Gate → Live with its country, network, score and reasons. Repeat it with the same eventId and it counts as a duplicate.
4. Tune, then enforce
- Add your LAN, router and monitoring IPs to the allowlist (Gate → Settings): they are never blocked.
- Watch the decisions for a few days; adjust thresholds or add rules.
- Switch the sensor to enforce; the bouncer starts applying blocks with their TTL.
- Add alert channels (email, Slack, Telegram) and webhooks.
Next steps
- Agent and bouncer: install, configure, nftables or ufw, dry-run.
- Log sources: parsers, Vector and Fluent Bit.
- API reference: events, logs, blocks, heartbeat, detectors, rules, webhooks.
- Example: GPS trackers and an alarm receiver.
Updated 2026-11-15 · API reference