Skip to main content

Features catalog

Curated install-time and controller/agent capability flags. Distinct from Firewall lease / NetPol / Shield toggles (those stay on the Firewall page).

CLI install, TLS/~/.netra defaults, and lifecycle commands: netractl.md.

Operator surfaces​

make install # put netractl on PATH first
netractl install # Helm + install CLI (needs ~/.netra or env for TLS)
netractl status # works with chart self-signed TLS via ~/.netra/env
netractl features list
netractl features enable dns-detect --yes
netractl features disable automitigate --yes
netractl ebpf maps # datapath map inventory (see ebpf-maps.md)
netractl upgrade
netractl uninstall --yes
  • CLI (netractl features) — primary path is helm upgrade --reuse-values --set …. Use --api to patch live Deployment/DaemonSet env via the controller instead.
  • API — GET /api/v1/features, POST /api/v1/features/{id} with body {"enabled":true|false} and header X-Netra-Confirm-Risk: high.
  • UX — Dashboard Diagnostics → Features. Overview shows a compact “features on” count.

Helm remains the durable source of truth for GitOps. API/UX patches are for live cluster ops; pods restart to pick up new env. Feature toggles never flip enforce mode or apply deny rules.

Catalog​

IDHelm keyEnvScopeChart default
agentagent.enabledDaemonSet presentcluster (Helm only)on
ciliumcilium.enabledNETRA_CILIUM_ENABLEDcontrolleroff (opt-in)
hubblehubble.enabledNETRA_HUBBLE_ENABLEDcontrolleroff (opt-in)
dns-detectdnsdetect.enabledNETRA_DNSDETECT_ENABLEDcontrolleron (GA)
scan-detectscandetect.enabledNETRA_SCANDETECT_ENABLEDcontrolleron (GA)
automitigateautomitigate.enabledNETRA_AUTOMITIGATE_ENABLEDcontrolleron (GA; lease-gated)
tlsfpagent.tlsfpNETRA_TLSFP (auto/off/required)agentauto (GA)
aiai.enabledNETRA_AI_BASE_URLcontrolleroff (needs credentials)
gitopsgitops.enabledNETRA_GITOPS_DIRcontrolleroff
workload-consoleworkloadConsole.enabledNETRA_WORKLOAD_CONSOLEcontrolleroff
alertingalerting.enabledNETRA_ALERT_POLL_INTERVALcontrolleroff (channels required)
auto-capturealerting.autoCapture.enabledNETRA_AUTO_CAPTUREcontrolleron (GA; bounded)

Shared package: internal/features.

Local / CI gate: ./scripts/ci-features-unit.sh (also make test-features).

Status​

netractl status prints a human-readable board (banner when TTY): version, datapath, mode, Cilium/Hubble, lease, agents, feature on/off counts, and per-node hooks. Flags: --json, --wait. Exit non-zero when agents are missing or all stale (controller-only installs are treated as healthy).

TLS: chart cert is self-signed — see netractl.md.

Install defaults​

make install # netractl → /usr/local/bin (PREFIX=$HOME/.local if needed)
make uninstall
netractl install-cli # same, from an already-built binary

netractl install wraps Helm with agent.enabled=true, tls.enabled=true, generated API/agent keys, optional --node-port, and also installs this CLI onto PATH (opt out with --skip-cli). Chart path: ./helm/netra, NETRA_CHART, or --chart. Remote deploys via scripts/deploy-remote.sh install netractl to /usr/local/bin (or ~/.local/bin) and write ~/.netra/env so bare netractl status works against the NodePort.