Release Notes 3.22.1

These release notes contain information about new features, improvements, known issues, and bug fixes in the NGINX Controller Application Delivery Module.

We encourage you to install the latest version of the NGINX Controller Application Delivery module to take advantage of the newest features and updates.

Technical support is provided for earlier versions that were released within two years of the current release.

See Also:

For related installation documentation, refer to the following publications:


January 13, 2022

Upgrade Considerations

Take note of the following considerations when upgrading to this version of the NGINX Controller App Delivery Module:

  • NGINX Controller App Delivery Module 3.22.1 does not support NGINX App Protect v3.8.

  • After upgrading NGINX Controller, make sure to upgrade the NGINX Controller Agent too.

    If you’re upgrading from NGINX Controller 3.18 or earlier to the NGINX Controller App Delivery Module 3.20 or later, the Controller Agent will go offline during the upgrade process.
  • If you’re upgrading NGINX Controller on a multi-node cluster, run the script on each node individually – the order in which you update the nodes doesn’t matter.

    Never update the control nodes in parallel. Doing so may result in race conditions for certain jobs, such as database migrations, and may cause the cluster to become unavailable.

What’s New

  • Support added for APIM Advanced Security licenses

    NGINX API Management Module with Advanced Security licenses are now supported.

Resolved Issues

This release includes the following fixes. To locate the details for an issue when it was first reported, search the NGINX Docs for the issue ID.

  • Adding or changing an Identity Provider resets configurations when placed on an Instance Group (31396)

    Adding or changing an Identity Provider resets configurations placed on Instance Groups in the same environment as the Identity Provider.

Known Issues

The following issues are known to be present in this release. Look for updates to these issues in future release notes.

  • Resubmitting snippets via the web interface can fail for gateways and components (32629)

    In specific circumstances, where special characters or empty strings are used in the directives, resubmitting snippets via the web interface might fail. This failure is due to information lost during the conversion of NGINX directives. This issue affects only snippets resubmitted using the UI. Direct API submissions are not affected.


    When updating a component or gateway that uses snippets, verify that the snippet is specified exactly as desired. If not, update the snippet before submitting the request.

Supported NGINX Plus Versions

NGINX Controller works with the following NGINX Plus versions:

  • NGINX Plus R25
  • NGINX Plus R24
  • NGINX Plus R23
  • NGINX Plus R22
  • NGINX Plus R21
  • NGINX Plus R20
  • NGINX Plus R19