1.22.1

fosrl/pangolin1.22.1Sep 3, 2026by oschwartz10612

AI Summary

This release focuses on fixes for Blueprints, security key handling, and license checks. It also enforces specific version requirements for AI Gateway components to ensure compatibility.

Key Highlights

Fixes for COUNTRY_IS_NOT rules created via Blueprints.
Fixes for access token deletion for root API keys and silent license failures.
Hardens initial server-admin setup against duplicate users and race conditions.
Requires Badger Traefik plugin v1.6.0+ and Gerbil 1.5.0+ for AI Gateway functionality.

New Features

Added IP column filtering to tables.
Added validation for health check hostname.
Improved warning display when changing IDP identifier mapping.

Full Release Notes

## Read the Announcement

Read the full announcement with discussion of new features: [Pangolin 1.22: AI Gateway for Cloud and Self-Hosted Models](https://pangolin.net/news/1-22-release)

## What's Changed

* Add IP column filtering to tables by @Fredkiss3 in https://github.com/fosrl/pangolin/pull/3627
* Fix COUNTRY_IS_NOT rules to be created via Blueprints by @argueta-xyz in https://github.com/fosrl/pangolin/pull/3647
* Fix domain namespaces and country is not in blueprints
* Fix access token deletion for root API keys
* Fix: License.check can fail silently by @shleeable in https://github.com/fosrl/pangolin/pull/3597
* Fix harden initial server-admin setup against duplicate users and races
* Fix resolve security-key login only for a unique internal user
* Fix add validation for health check hostname
* Fix pull all matching users into blueprint instead of one
* Improvement show warning when changing idp identifier mapping
* Update dependencies

**Full Changelog**: https://github.com/fosrl/pangolin/compare/1.21.1...1.22.0

## New Contributors
* @argueta-xyz made their first contribution in https://github.com/fosrl/pangolin/pull/3647
* @iMord0 made their first contribution in https://github.com/fosrl/pangolin/pull/3654
* @moverq1337 made their first contribution in https://github.com/fosrl/pangolin/pull/3655
* @aithal007 made their first contribution in https://github.com/fosrl/pangolin/pull/3628

## How to Update

> [!IMPORTANT]
>  AI gateway resources require the Badger Traefik plugin version `v1.6.0` or greater. The migration will automatically do this if it can find the Traefik config in the standard location. Otherwise, [please ensure your Badger is up to date](https://docs.pangolin.net/self-host/how-to-update#:~:text=Increase%20the%20Badger%20version%20number).  

> [!IMPORTANT]
>  Private AI gateway resources require Gerbil to be on the latest version `1.5.0`. The migration will NOT automatically attempt to update Gerbil. Therefore, you must manually increment your Gerbil container version.

> [!IMPORTANT]
> Private AI gateway resources are exclusively compatible with the latest versions of all Pangolin clients. Support for gateway functionality was implemented in all client releases issued after August 19th, 2026. If your client's most recent release predates this date, private gateway access is not yet available.

> [!IMPORTANT]
> Always back up your config app-data before updating. This will allow you to easily roll back if the update breaks your configuration. You will not be able to easily downgrade otherwise.

[View documentation](https://docs.pangolin.net/self-host/how-to-update)