Release notes

How Ferriskey has been taking shape, release after release.

A curated timeline of stable Ferriskey releases, condensed from the public GitHub history into product-level notes.

Based on the public release history of ferriskey/ferriskey on GitHub.

Stable release timeline

Each section starts from a milestone release. The newer fixes released for that same line are grouped with it.

v0.4.3

March 24, 2026

0.4 line
Patch release Latest usable in line

v0.4.3

March 24, 2026

Authentication URL hardening and release alignment

A focused patch that hardens authentication and registration URL generation, especially when Ferriskey runs behind a root path or a webapp URL with trailing slashes.

  • Normalizes login URL construction to avoid double slashes in authentication redirects.
  • Applies root-path aware base URLs to authenticate, registration, and token exchange handlers.
  • Bumps workspace and Helm chart versions together so the shipped artifacts stay aligned.
Patch release

v0.4.2

March 13, 2026

Dockerfile and Nginx packaging fixes

A packaging-focused patch release that fixes the delivery layer around the web application, with corrections in the Docker entrypoint, Dockerfile flow, and Nginx configuration.

  • Fixes the Dockerfile path so the packaged web application boots with the expected assets.
  • Corrects the container entrypoint behavior in the release build.
  • Updates Nginx configuration so the shipped image serves the app correctly.
Patch release

v0.4.1

March 12, 2026

Authentication callback flow refinement

A patch release centered on the authentication callback path, tightening refresh-token behavior and smoothing the post-login handoff.

  • Fixes the authentication callback flow after the broader 0.4.0 changes.
  • Adjusts refresh-token logic so sign-in completion behaves more predictably.
  • Stabilizes the handoff between the login journey and token lifecycle.

v0.4.0

March 12, 2026

Milestone release

Client scopes, Compass observability, and account recovery foundations

v0.4.0 · March 12, 2026

Version 0.4.0 is a major step forward for platform teams: token shaping improves, authentication flows become observable, and user recovery starts to land as a complete subsystem.

  • Introduces client scopes, mappings, migrations, and API support for better token composition.
  • Launches Compass runtime, database layer, API endpoints, and UI to inspect authentication flows.
  • Adds password reset and SMTP management building blocks, including UI and infrastructure.

Once federation was established in 0.3.0, the next logical move was to improve policy control, visibility, and recovery across the sign-in journey.

v0.3.0

February 2, 2026

Milestone release Latest usable in line

Federation becomes real

v0.3.0 · February 2, 2026

Ferriskey expands beyond local identity management with federation primitives, social login, LDAP support, and SSO endpoints.

  • Adds the Abyss federation module and user federation entities and migrations.
  • Ships social auth APIs, LDAP provider CRUD, sync and connection test endpoints.
  • Improves login UX, error detail quality, and permissions hydration in the app.

At this point the project stops being only an internal IAM console and starts addressing real-world enterprise identity integration problems.

v0.2.1

January 16, 2026

0.2 line
Patch release Latest usable in line

v0.2.1

January 16, 2026

Maintenance patch for the 0.2 line

A small release that backports the necessary fixes to keep the 0.2 branch versioned and consumable while larger federation work continues on main.

  • Cherry-picks targeted fixes from main into the 0.2 release line.
  • Corrects release versioning before the next milestone.
  • Keeps existing adopters on a stable branch without forcing a larger upgrade.

v0.2.0

December 30, 2025

Milestone release

Operations, webhooks, and admin surface expansion

v0.2.0 · December 30, 2025

Ferriskey broadens its operator story with webhooks, required actions, stronger admin pages, and the first serious steps toward event-driven integrations.

  • Introduces webhook notifications and required actions in the authentication journey.
  • Expands admin UX with realm settings, login settings, IdP overview, and UI polish across clients and roles.
  • Lays groundwork for SeaWatch and strengthens deployment support with TLS and Docker improvements.

From here the roadmap opens up: not just authenticating users, but integrating identity events into the rest of the platform.

v0.1.1

August 11, 2025

0.1 line
Patch release Latest usable in line

v0.1.1

August 11, 2025

First post-launch hardening pass

The first patch release focuses on correctness and release hygiene right after the initial public milestone.

  • Fixes session cookie handling to make authentication flows safer.
  • Corrects Docker Compose execution context issues.
  • Cleans up the Helm release workflow so tags are published more predictably.

v0.1.0

August 7, 2025

Milestone release

The first public Ferriskey baseline

v0.1.0 · August 7, 2025

The first stable release establishes the platform core: realms, clients, users, roles, OpenID endpoints, admin UI, packaging, and deployment tooling.

  • Delivers the foundational IAM surface: realms, clients, roles, permissions, users, and authentication endpoints.
  • Ships the first admin portal flows, including login, client management, role management, and user management.
  • Adds Helm, operator, Docker, metrics, and documentation so Ferriskey can be evaluated as a real platform.