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 ishelm upgrade --reuse-values --set …. Use--apito 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 headerX-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
| ID | Helm key | Env | Scope | Chart default |
|---|---|---|---|---|
agent | agent.enabled | DaemonSet present | cluster (Helm only) | on |
cilium | cilium.enabled | NETRA_CILIUM_ENABLED | controller | off (opt-in) |
hubble | hubble.enabled | NETRA_HUBBLE_ENABLED | controller | off (opt-in) |
dns-detect | dnsdetect.enabled | NETRA_DNSDETECT_ENABLED | controller | on (GA) |
scan-detect | scandetect.enabled | NETRA_SCANDETECT_ENABLED | controller | on (GA) |
automitigate | automitigate.enabled | NETRA_AUTOMITIGATE_ENABLED | controller | on (GA; lease-gated) |
tlsfp | agent.tlsfp | NETRA_TLSFP (auto/off/required) | agent | auto (GA) |
ai | ai.enabled | NETRA_AI_BASE_URL | controller | off (needs credentials) |
gitops | gitops.enabled | NETRA_GITOPS_DIR | controller | off |
workload-console | workloadConsole.enabled | NETRA_WORKLOAD_CONSOLE | controller | off |
alerting | alerting.enabled | NETRA_ALERT_POLL_INTERVAL | controller | off (channels required) |
auto-capture | alerting.autoCapture.enabled | NETRA_AUTO_CAPTURE | controller | on (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.