Changelog & Releases
Elchi is a multi-component platform, and each component is released and versioned independently. Rather than duplicate release notes here, this page points you to the authoritative source for each component and explains how their versions relate.
Release notes by component
Every component publishes its release notes on GitHub. The distribution mirror, elchi-archive, is the single public place where installable artifacts (binaries, charts, install scripts) are re-published for unauthenticated download.
| Component | What it is | Releases |
|---|---|---|
| elchi (UI) | The management console | elchi-archive/releases |
| elchi-backend | Controller + Control-Plane + Registry | elchi-archive/releases |
| elchi-client | The edge agent (bundles Shield) | elchi-archive/releases |
| elchi-shield | The ext_proc API-security sidecar | elchi-archive/releases |
| elchi-collector | The API Discovery ingest service | elchi-archive/releases |
| Helm charts | elchi-stack, elchi-discovery | charts.elchi.io |
| Install scripts / mirror | Standalone + single-host installers | elchi-archive/releases |
The UI and backend version badges in the top navigation bar always show the latest
published release of each — they are read at build time from the public release
archive (archive.elchi.io/index.json), which is also where the installers and
the appliance pull their artifacts from.
Release highlights
Short summaries of notable feature releases, with links into the docs. The component release notes above remain the authoritative list of versions, fixes and upgrade steps.
Edge HA Pairs — October 2026
Spans elchi-backend, elchi-client, the elchi UI, elchi-proto and Elchi OS; check each component's release notes for the exact versions.
- Active/passive VIP pairs. Two Elchi OS appliances serve the same services
on the same VIPs; the
elchi-hadaemon on the boxes elects the active member, which holds the VIPs, and the standby takes over in about two seconds — see Edge HA Pairs. - HA mode. A single appliance can start as a pair of one and gets its services mirrored to a second box when that one is added — see Setting up a pair.
- Pair-aware deploys. One deploy to both members at one VIP; on-link VIPs, routed VIPs through floating next-hops or BGP; standby-first restarts, bootstrap updates and listener upgrades — see Deploying services.
- Operations. Planned and forced failover, maintenance mode, heartbeat key rotation, member replacement, flap suspension, standby-first OS upgrades — see Failover & Maintenance.
- Visibility. HA Pairs page, pair status and roles on clients, services and
the dashboard,
HA_ROLE_CHANGEaudit entries andelchi_ha_*metrics — see Monitoring a pair;show haandsystem haon the appliance console — see Appliance commands. - BFD for BGP neighbours. A per-neighbour BFD switch lets a router drop a dead member's routes in about a second.
- Shared-address fixes. Clients serving the same address (HA pairs and BGP ECMP) are now tracked per client: removing one no longer clears the others' snapshot, and the controller keeps the shared GSLB row and OpenStack port while another client still uses them.
API Discovery — October 2026
Spans elchi-backend, elchi-collector, the elchi UI and elchi-shield; check each component's release notes for the exact versions.
- Active vs historical findings. Flags, PII categories and auth markers carry
last-seen stamps; findings older than
policy.risk_active_days(default 7) become historical, and lists, filters, dashboards and drift use the active view.mixed_auth_schemes(now info),auth_inconsistentandcors_origin_reflection(foreign origins only) are derived at read time and decay on their own — see Risk Flags Reference. - Active scores and a gated Security Score. Endpoints sort and filter by their active threat / exposure score; the Security Score is 0–100 with an A–F grade and excludes pillars with insufficient data — see Risk Scoring.
- False-positive-first defaults. BOLA, brute force and payment abuse need a failure share, path scan counts only 404/405, impossible travel needs two continent switches (or one onto a hosting / VPN AS), replay fingerprints only signed / nonce-bound requests. Collector Mongo migration 009 moves only untouched old defaults.
- PII. Turkish national id (TCKN, named or endpoint-level evidence) and Turkish mobile numbers; per-detector reporting switches; configurable credential query-parameter names — see PII, Auth & Consumers.
- Cookie-session apps are recognised as authenticated without cookie
inspection, through the managed
elchi-cookie-namesfilter. - TLS behind a proxy.
policy.trusted_tls_proxy_cidrs+x-forwarded-protocount proxy-terminated TLS as TLS. - Consumers & enumeration. Persistent consumer records, machine vs human callers, new-consumer and trend signals, enumeration / scraping / auth-failure indicators and per-endpoint enumerators — see Consumers & Enumeration.
- OpenAPI specs & coverage. Versioned spec import with listener / host / path scopes; documented, undocumented, unused, deprecated-in-use, parameter and status drift — see OpenAPI Specs & Coverage.
- Drift & ownership. Daily snapshots with a change feed (Drift & Snapshots); ownership rules, overrides, a Teams tab and CSV export (Ownership & Teams).
- Learned path templating. Letter+digit ids are learned per position and
merged into
{id}rows, with pin / unlearn overrides — see Path Normalization. - GraphQL operations are inventoried one row per operation from request metadata; collector ClickHouse migration 014 adds operation dimensions to the rollups, so errors and analytics split by operation.
- Exact windows and sampling. Error and analytics windows are exact to the
minute; with raw sampling, event counts are weighted by
sample_weight(ClickHouse migration 013). - Shield. DLP
tr_national_idandphonekinds (named mode by default), JWT / JWKSclaim_bindings, and policy bundles that carry their ownfiles/…data files. Deploy the new Shield before the backend that emits these fields.
How the pieces are versioned
- Components version independently. The UI, backend, Shield, collector, and client each move on their own cadence. A given platform install pins a specific version of each (see the installer's version flags on install.sh and upgrade.sh).
- Shield ships with the client. Each
elchi-clientrelease bundles a matchingelchi-shieldversion, so upgrading the edge agent upgrades Shield with it (see Client installation). - Envoy versions are decoupled. Supported Envoy versions are discovered dynamically from the release archive, not pinned to a platform version — see Versions & Upgrades for the model and how your resources move between them.
- Backend release tags encode the trio. Backend tags carry the platform,
control-plane, and Envoy versions together (for example
elchi-v1.6.18-v0.14.0-envoy1.39.3), so a tag tells you exactly which control-plane and Envoy baseline it targets.
Upgrading
- Helm: bump the chart/app versions and
helm upgrade— see Platform installation. - Bare-metal: upgrade.sh performs a version-diff upgrade across the stack.
- Edge clients: re-run the client installer to pick up a new agent + Shield bundle.
Always read the target release's notes before upgrading — breaking changes and migration steps are called out there.