Skip to content
dfluxdocs
dflux.io

v0.1.1

Released 2026-11-09 · tag runik/v0.1.1

A fix release. Runik now has full user documentation at docs.dflux.io/runik, and reviewing those docs against the code turned up the fixes below.

Upgrading

  • Unknown YAML keys are now an error. Flow, suite, environment and subscriber files decode strictly. A misspelt or unsupported key stops the load and names the file, line and key, with the nearest known key ("did you mean"). Before, it was silently ignored. Run rk lint over your own flows and configs before you upgrade. The public d3x-templates load unchanged.
  • Diameter tls: true over SCTP is refused at load. Before, it was silently ignored and the peer ran in plain text. Over TCP it now works (see below).

Fixes

  • rk server uspace and rk server dpdk exit codes now match the rest of rk:

    • 5 for a licence refusal (datapath.dpdk, or obs.prometheus for -metrics-port); it was 1;
    • 2 for a usage error: a missing or bad -protocol, no backend or an unknown one, a bad -gtpu-teid;
    • 4 when the socket or the metrics listener can't start.
  • rk server dpdk -metrics-port now serves Prometheus /metrics on -metrics-addr:-metrics-port (needs the obs.prometheus feature). The runik_server_dpdk_* metrics cover packets and bytes in and out, G-PDUs received and reflected, drops by reason, and active seconds. They're read at scrape time from the same counters as the run's report, so the two always agree.
  • Diameter over TLS: a peer with transport: tcp and tls: true now dials TLS before CER (RFC 6733 §13.1). New peer keys: ca_file, server_name, and cert_file with key_file.

Documentation

  • New user docs at docs.dflux.io/runik: install, quickstart and licensing; flows, suites, the environment, subscribers and the user plane; guides for CI, load runs, testing a UPF, fuzzing and daemon mode; and references for exit codes, reports, metrics, the CLI and the environment config, generated from the code.
  • From this release on, each Runik version publishes its own docs and these notes there.

Compatibility

  • Same platforms and builds as v0.1.0: Linux amd64 and arm64; the full build (DPDK) is linux amd64 only.
  • Runik Control: not yet released; rk daemon remains for preview deployments only.
  • Flow templates: the public d3x-templates repository, unchanged.