v2.2.20 backend/v3.1.0

high risk

evcc-io/evccSep 30, 2026 → Oct 1, 20261 day between releases

What's New

Introduces Organizations/Roles and Custom Claims; changes Client IP resolution default.

Breaking Changes

  • Client IP resolution defaults to 'direct' mode, requiring proxy config updates for reverse proxy setups.

New Features

  • New Organizations and Roles feature for grouping users
  • Custom Claims mapping support for SAML and OIDC providers
  • Session lifecycle webhooks for login and logout events

Improvements

  • Axios upgraded to version 1.20.0
  • Improved user imports
  • Security fixes for client IP extraction

Bug Fixes

  • Fixed Kanban layout flicker when adding AI employee actions
  • Fixed approval form variables in quick create popups
  • Fixed hidden field labels and empty values in approval details

Upgrade Notes

Self-hosters using reverse proxies must update configuration to use 'x_forwarded_for' or 'x_real_ip' with trusted_proxies. Applications using the new Organizations and Roles feature must integrate the new APIs to manage user access scopes.

The Two Releases

v2.2.20

v2.2.20

Sep 30, 2026· 21 days ago

This release enhances AI employee chat capabilities by exposing referenced knowledge base documents and includes various bug fixes related to dependency upgrades and UI interactions.

Full release notes
backend/v3.1.0

Hanko v3.1

Oct 1, 2026· 20 days ago

Introduces Organizations and Roles for B2B applications, Custom Claims mapping, and a critical security fix regarding client IP resolution.

Full release notes